Vous êtes sur la page 1sur 10

# 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

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

## 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

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

Example:
See "Time : " + time()

186
Ring Documentation, Release 1.5.1

## 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

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

Example:
cDate = date()
see cDate + nl # 24/05/2015
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
see cDate2 + nl # 03/06/2015
see "DiffDays = " + diffdays(cDate1,cDate2) + nl # -10
see "DiffDays = " + diffdays(cDate2,cDate1) + nl # 10

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
#---------------------------------------------------------------

## 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

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

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

## 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

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

## 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

## 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

## 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

## 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

## 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

## 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

## 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

## 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

## 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

## 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