Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Info

time:atom() and , time:compare(), and time predicates have not yet been ported to the new pico engine.

...

The default time zone is determined by the operating system running Node and is used if an invalid time zone is provided. The list of valid time zones is updated periodically — for example, version 0.3540.0 of the core engine used IANA TZDB 2017b.

...

time:new() - returns a new RFC 3339 datetime string () from a string formatted as described in ISO8601 (v2000). It assumes UTC unless otherwise specified.

Code Block
languagejavascript
themeConfluence
time:new("2010-08-08")            # 2010-08-08T00:00:00Z (Date only—defaults to 00:00)
time:new("67342")                 # NOT SUPPORTED YET
                   1967342")               # 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)

...

Code Block
languagejavascript
themeConfluence
time:add("2011W206T1345-0600",{"days": -65})      # 2011-03-17T13:45:00Z
time:add("2010-08-08",{"weeks": 5})              # 2010-09-12T00:00:00Z
time:add("673421967342",{"hours": 3})                    # NOT SUPPORTED YET
                                                  # 1967-12-08T04:00:00Z
time:add("083023Z",{"minutes": 10})             # 2010-10-06T08:40:23Z
time:add("083023Z1970-01-01",{"seconds": 6321286388924})  # 2010-10-06T18:15:24Z
time:add("1967342", {"milliseconds": 5})        # 20101967-1012-06T0808T00:4000:55Z00.005Z
time:add("1970-01-011967342", {"secondsms": 12863889245})                  # 20101967-1012-06T1808T00:1500:24Z00.005Z

Unrecognized time units are ignored. The exact rules can get complicated considering leap years, different month lengths, and adding (or subtracting) multiple units at once versus one after another. See http://momentjs.com/docs/#/manipulating/add/ (the time module uses a version above 2.18.0). UTC does not have daylight savings time.

...

time:strftime() - returns a datetime string in a specified format following POSIX strftime conventions. It assumes the default time zone of the operating system running Node.

Code Block
languagejavascript
themeConfluence
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. If the format string is invalid, the format string is returned as is.


Note

The third argument below is not yet implemented.

...