Ring Documentation, Release 1.5.

mystr = "Hello
How are you ?
are you fine ?
ok"

mylist = str2list(mystr)
see "Items : " + len(mylist) + nl

for x in mylist
see "Item : " + x + nl
next

newstr = list2str(mylist)
see "list2Str result = " + newstr

if mystr = newstr
see nl + "Done"
else
see nl + "Error!"
ok

27.16. str2list() and list2str() Functions 185

 CHAPTER

TWENTYEIGHT

DATE AND TIME

In this chapter we are going to learn about the date and time functions.

28.1 Clock() Function

Syntax:
Clock() ---> The number of clock ticks from program start

Example:
See "Calculate performance" + nl
t1 = clock()
for x = 1 to 1000000 next
see clock() - t1

28.2 ClocksPerSecond() Function

Return how many clocks in one second

Syntax:
clockspersecond() ---> Number of clocks in one second

Example:
# Wait 1 second
t = clock()
while clock() - t <= clockspersecond() end

28.3 Time() Function

We can get the system time using the Time() function.

Example:
See "Time : " + time()

186
 Ring Documentation, Release 1.5.1

28.4 Date() Function

We can get the date using the Date() function.

Syntax:
Date() ---> String represent the date "dd/mm/yyyy"

Example:
See "Date : " + date() # Date : 24/05/2015

28.5 TimeList() Function

We can print the date and the time information using the TimeList() function.
Syntax:
TimeList() ---> List contains the time and date information.

The next table presents the list items

index value
1 abbreviated weekday name
2 full weekday name
3 abbreviated month name
4 full month name
5 Date & Time
6 Day of the month
7 Hour (24)
8 Hour (12)
9 Day of the year
10 Month of the year
11 Minutes after hour
12 AM or PM
13 Seconds after the hour
14 Week of the year (sun-sat)
15 day of the week
16 date
17 time
18 year of the century
19 year
20 time zone
21 percent sign
Example:
/* Output:
** Sun abbreviated weekday name
** Sunday full weekday name
** May abbreviated month name
** May full month name
** 05/24/15 09:58:38 Date & Time
** 24 Day of the month
** 09 Hour (24)

28.4. Date() Function 187

 Ring Documentation, Release 1.5.1

** 09 Hour (12)
** 144 Day of the year
** 05 Month of the year
** 58 Minutes after hour
** AM AM or PM
** 38 Seconds after the hour
** 21 Week of the year (sun-sat)
** 0 day of the week
** 05/24/15 date
** 09:58:38 time
** 15 year of the century
** 2015 year
** Arab Standard Time time zone
** % percent sign
*/

See TimeList()

Example:
See "Day Name : " + TimeList()[2] # Sunday

Example:
See "Month Name : " + TimeList()[4] # May

28.6 AddDays() Function

Syntax:
AddDays(cDate,nDays) ---> Date from cDate and after nDays

Example:
cDate = date()
see cDate + nl # 24/05/2015
cDate = adddays(cDate,10)
see cDate + nl # 03/06/2015

28.7 DiffDays() Function

Syntax:
DiffDays(cDate1,cDate2) ---> number of days (Date1 - Date2)

Example:
cDate1 = date()
see cDate1 + nl # 24/05/2015
cDate2 = adddays(cDate1,10)
see cDate2 + nl # 03/06/2015
see "DiffDays = " + diffdays(cDate1,cDate2) + nl # -10
see "DiffDays = " + diffdays(cDate2,cDate1) + nl # 10

28.6. AddDays() Function 188

 Ring Documentation, Release 1.5.1

28.8 EpochTime() Function

Syntax:
EpochTime( cDate, cTime ) ---> Epoch Seconds

Example:
###-------------------------------------------------------------
# EpochTime()
# Example --- EpochSec = EpochTime( Date(), Time() )
# Call Format: EpochSec = EpochTime( "15/07/2016", "10:15:30" )
# EpochSec = 1468577730
#---------------------------------------------------------------

Func EpochTime(Date, Time)

arrayDate = split(Date, "/")

arrayTime = split(Time, ":")

Year = arrayDate[3] ; Month = arrayDate[2] ; Day = arrayDate[1]

Hour = arrayTime[1] ; Minute = arrayTime[2] ; Second = arrayTime[3]

cDate1 = Day +"/"+ Month +"/"+ Year

cDate2 = "01/01/" + Year
DayOfYear = DiffDays( cDate1, cDate2)

### Formula
tm_sec = Second * 1
tm_min = Minute * 60
tm_hour = Hour * 3600
tm_yday = DayOfYear * 86400
tm_year = Year - 1900

tm_year1 = ( tm_year - 70) * 31536000

tm_year2 = ( floor(( tm_year - 69) / 4 )) * 86400
tm_year3 = ( floor(( tm_year - 1) / 100 )) * 86400
tm_year4 = ( floor(( tm_year + 299) / 400 )) * 86400

### Result
EpochSec = tm_sec + tm_min + tm_hour + tm_yday + tm_year1 + tm_year2 - tm_year3 + tm_year4

return EpochSec

28.8. EpochTime() Function 189

 CHAPTER

TWENTYNINE

CHECK DATA TYPE AND CONVERSION

In this chapter we are going to learn about the functions that can be used for
Checking Data Type
Checking Character
Conversion

29.1 Check Data Type

The next functions can be used to check the data type

isstring()
isnumber()
islist()
type()
isnull()

29.2 IsString() Function

Using the IsString() function we can know if the value is a string or not
Syntax:
IsString(value) ---> 1 if the value is a string or 0 if not

Example:
see isstring(5) + nl + # print 0
isstring("hello") + nl # print 1

29.3 IsNumber() Function

Using the IsNumber() function we can know if the value is a number or not
Syntax:

190
 Ring Documentation, Release 1.5.1

IsNumber(value) ---> 1 if the value is a number or 0 if not

Example:
see isnumber(5) + nl + # print 1
isnumber("hello") + nl # print 0

29.4 IsList() Function

Using the IsList() function we can know if the value is a list or not
Syntax:
IsList(value) ---> 1 if the value is a list or 0 if not

Example:
see islist(5) + nl + # print 0
islist("hello") + nl + # print 0
islist([1,3,5]) # print 1

29.5 Type() Function

We can know the type of a value using the Type() Function.

Syntax:
Type(value) ---> The Type as String

Example:
see Type(5) + nl + # print NUMBER
Type("hello") + nl + # print STRING
Type([1,3,5]) # print LIST

29.6 IsNULL() Function

We can check the value to know if its null or not using the IsNULL() function
Syntax:
IsNULL(value) ---> 1 if the value is NULL or 0 if not

Example:
see isnull(5) + nl + # print 0
isnull("hello") + nl + # print 0
isnull([1,3,5]) + nl + # print 0
isnull("") + nl + # print 1
isnull("NULL") # print 1

29.4. IsList() Function 191

 Ring Documentation, Release 1.5.1

29.7 Check Character

The next functions can be used to check character

isalnum()
isalpha()
iscntrl()
isdigit()
isgraph()
islower()
isprint()
ispunct()
isspace()
isupper()
isxdigit()

29.8 IsAlNum() Function

We can test a character or a string using the IsAlNum() Function

Syntax:
IsAlNum(value) ---> 1 if the value is digit/letter or 0 if not

Example:
see isalnum("Hello") + nl + # print 1
isalnum("123456") + nl + # print 1
isalnum("ABCabc123") + nl + # print 1
isalnum("How are you") # print 0 because of spaces

29.9 IsAlpha() Function

We can test a character or a string using the IsAlpha() Function

Syntax:
IsAlpha(value) ---> 1 if the value is a letter or 0 if not

Example:
see isalpha("Hello") + nl + # print 1
isalpha("123456") + nl + # print 0
isalpha("ABCabc123") + nl + # print 0
isalpha("How are you") # print 0

29.7. Check Character 192

 Ring Documentation, Release 1.5.1

29.10 IsCntrl() Function

We can test a character or a string using the IsCntrl() Function

Syntax:
IsCntrl(value) ---> 1 if the value is a control character (no printing position) or 0 if not

Example:
See iscntrl("hello") + nl + # print 0
iscntrl(nl) # print 1

29.11 IsDigit() Function

We can test a character or a string using the IsDigit() Function

Syntax:
IsDigit(value) ---> 1 if the value is a digit or 0 if not

Example:
see isdigit("0123456789") + nl + # print 1
isdigit("0123a") # print 0

29.12 IsGraph() Function

We can test a character or a string using the IsGraph() Function

Syntax:
IsGraph(value) ---> 1 if the value can be printed (Except space) or 0 if not

Example:
see isgraph("abcdef") + nl + # print 1
isgraph("abc def") # print 0

29.13 IsLower() Function

We can test a character or a string using the IsLower() Function

Syntax:
IsLower(value) ---> 1 if the value is lowercase letter or 0 if not

Example:
see islower("abcDEF") + nl + # print 0
islower("ghi") # print 1

29.10. IsCntrl() Function 193

 Ring Documentation, Release 1.5.1

29.14 IsPrint() Function

We can test a character or a string using the IsPrint() Function

Syntax:
IsPrint(value) ---> 1 if the value occupies a printing position or 0 if not

Example:
see isprint("Hello") + nl + # print 1
isprint("Nice to see you") + nl + # print 1
isprint(nl) # print 0

29.15 IsPunct() Function

We can test a character or a string using the IsPunct() Function

Syntax:
IsPunct(value) ---> 1 if the value is a punctuation character or 0 if not

Example:
see ispunct("hello") + nl + # print 0
ispunct(",") # print 1

29.16 IsSpace() Function

We can test a character or a string using the IsSpace() Function

Syntax:
IsSpace(value) ---> 1 if the value is a white-space or 0 if not

Example:
see isspace(" ") + nl + # print 1
isspace("test") # print 0

29.17 IsUpper() Function

We can test a character or a string using the IsUpper() Function

Syntax:
IsUpper(value) ---> 1 if the value is an uppercase alphabetic letter or 0 if not

Example:
see isupper("welcome") + nl + # print 0
isupper("WELCOME") # print 1

29.14. IsPrint() Function 194