...
Code Block | ||||
---|---|---|---|---|
| ||||
time:new("2010-08-08") # 2010-08-08T00:00:00Z (Date only—defaults to 00:00) time:new("67342") # 1967-12-08T00:00:00Z (Year DayOfYear) time:new("2011W206T1345-0600") # 2011-05-21T19:45:00Z (Year WeekOfYear DayOfWeek) time:new("083023Z") # 2010-10-05T08:30:23Z (Time only—defaults to today) |
Valid formats for the datetime source string can be found in ISO8601 (v2000).
time:add()
time:add() - adds (or subtracts) a specific number of time units to a source string.
...
Code Block | ||||
---|---|---|---|---|
| ||||
time:strftime(xTime, "%F %T") # 2010-10-06 18:15:24 time:strftime(xTime, "%F") # 2010-10-06 time:strftime(xTime, "%T") # 18:19:29 time:strftime(xTime, "%A %d %b %Y") # Wednesday 06 Oct 2010 time:strftime(xTime, "%c") # Oct 6, 2010 6:25:55 PM time:strftime(xTime, "%s") # 1286388924 -- seconds since epoch |
Valid format arguments to strftime follow the POSIX strftime conventions.
time:atom()
time:atom() - converts a datetime string to an ATOM compatible form.
...
All of the following predicates are referenced to the user's local time. All times are 24-hour clock. All predicates must be preceded by the modules name, for example:
time:weekend()
timezone
timezone(<arg>) - takes a timezone abbreviation as the argument and checks the user's geo-location (based on IP address) and returns true or false
Code Block | ||||
---|---|---|---|---|
| ||||
rule glee_check {
select when pageview ".*"
if (time:timezone("MST")) then {
notify("Glee alert", "Glee starts at 7pm");
}
} |
daytime
time:daytime() - returns true if it is between sunrise and sunset, otherwise returns false.
nighttime
time:nighttime() - returns true if it is between sunset and sunrise, otherwise returns false.
morning
time:morning() - returns true if it is between 0600 and 1200 hours, otherwise returns false.
afternoon
time:afternoon() - returns true if it is between 1200 and 1700 hours, otherwise returns false.
evening
time:evening() - returns true if it is bewteen 1700 and 2000 hours, otherwise returns false.
night
time:night() - returns true if it is between 2000 and 2400 hours, otherwise returns false.
lunch_time
time:lunch_time() - returns true if it is between 1130 and 1300 hours, otherwise returns false.
late_morning
time:late_morning - returns true if it is between 1000 and 1200 hours, otherwise returns false.
early_afternoon
time:early_afternoon - returns true if it is between 1200 and 1500 hours, otherwise returns false.
late_afternoon
time:late_afternoon - returns true if it is between 1500 and 1700 hours, otherwise returns false.
time_between
time:time_between(<start hour>, <start minute>, <end hour>, <end minute>) - returns true if local time is between the time specified, otherwise returns false.
date_between
time: date_between(<start month>, <start day>, <start year>, <end month>, <end day>, <end year>) - returns true if the local time is between the specified dates (midnight), otherwise returns false.
date_start
time:date_start(<start month>, <start day>, <start year>) - returns true if the local time is on (or after) the specified date, otherwise returns false.
day_of_week
time:day_of_week(<day name>) - returns true if the current day of the week matches the name (capitalized) given as an argument, otherwise returns false.
today_is
time:today_is(<sun>, <mon>,<tue>, <wed>, <thur>, <fri>, <sat>) - returns true if it is the current day of the week, otherwise returns false. Note: Each argument must be either a 1 or 0 to indiate whether to check if today is the day of the week.
weekday
time:weekday() - returns true if today is a weekday, otherwise returns false.
weekend
time:weekend() - returns true if today is the weekend, otherwise returns false.