dateItems

Typekeyword
DictionaryLCS
LibraryLiveCode Script
Syntax
dateItems
Summary

Designates a comma-delimited date format used with the convert command.

Introduced1.0
OSmac, windows, linux, ios, android
Platformsdesktop, server, mobile
Example
convert myVariable to dateItems
convert it from dateItems to long date and long time
RelatedCommand: convert
Function: date, seconds, time
Glossary: command, keyword
Description

Use the dateItems keyword with the convert command to store a date and/or time.

The dateItems format is a comma-separated list of numbers:

  • the year
  • the month number
  • the day of the month
  • the hour in 24-hour time
  • the minute
  • the second
  • the numeric day of the week where Sunday is day 1, Monday is day 2, and so forth

The dateItems does not change depending on the user's settings, so you can use it (or the seconds format) to store a date and time in an invariant form that won't change.

Note: A list in dateItems format can have values beyond the expected range for any given item (e.g. a day of the month of less than 1 or greater than the number of days in that month) without causing issues when converting it again later, outputting a date adjusted for such an irregularity. For example, the date 4 weeks from today can be determined by adding 28 to the third item (i.e. the day of the month) and then re-converting.

put the date into foo           -- 9/19/19, for example
convert foo to dateItems        -- 2019,9,19,0,0,0,5
add 28 to the item 3 of foo     -- 2019,9,47,0,0,0,5
convert foo to date             -- 10/17/19

Tagsmath