Date and Time API Functions: Unterschied zwischen den Versionen
Cg (Diskussion | Beiträge) |
Cg (Diskussion | Beiträge) |
||
| Zeile 33: | Zeile 33: | ||
Date <code>today</code> => a date |
Date <code>today</code> => a date |
||
::provides the current date |
::provides the current date |
||
Date <code>tomorrow</code> => a date |
|||
::provides the date of tomorrow |
|||
Date <code>yesterday</code> => a date |
|||
::provides the date of yesterday |
|||
Date <code>year:</code>''yearNr'' <code>month:</code>''monthNr'' <code>day:</code>''dayNr'' => a date |
|||
::for example, "(Date year:2025 month:4 day:20)" generates 20-04-2025 (i.e. 20th April 2025) |
|||
==== Arithmetic ==== |
==== Arithmetic ==== |
||
Version vom 5. Januar 2022, 17:42 Uhr
This document lists most useful (and most often needed) functions. Be aware, that there are many more to be found in either the class references or via the builtin class browser.
Reference: Date Time Timestamp TimeDuration
Inhaltsverzeichnis
Time[Bearbeiten]
Time instances represent a time-of-day (i.e. "hh:mm:ss" within a single day). Times are seldom used - usually timestamps are better suited.
Creation[Bearbeiten]
Time now => a time
- provides the current time of day
Arithmetic[Bearbeiten]
aTime addSeconds: nSeconds => a time
aTime addMinutes: nMinutes => a time
aTime addHours: nHours => a time
- to compute times
Accessing[Bearbeiten]
aTime hours => hours (0..24)
aTime minutes => hours (0..59)
aTime seconds => hours (0..59)
- to retrieve the hour, minute and second component:
Date[Bearbeiten]
Date instances represent a date (i.e. "dd-mm-yyyy"). Dates are seldom used - usually timestamps are better suited.
Creation[Bearbeiten]
Date today => a date
- provides the current date
Date tomorrow => a date
- provides the date of tomorrow
Date yesterday => a date
- provides the date of yesterday
Date year:yearNr month:monthNr day:dayNr => a date
- for example, "(Date year:2025 month:4 day:20)" generates 20-04-2025 (i.e. 20th April 2025)
Arithmetic[Bearbeiten]
aDate addDays: numDays => a date
- to compute a date numDays after aDate
aDate subtractDays: numDays => a date
- to compute a date numDays before aDate; for example: "(Date today subtractDays:7)"
aDate subtractDate: date2 => nr of days
- to compute the number of days since 1.1.1900, use: "(Date today subtractDate:(Date year:1900 month:1 day:1))"
Accessing[Bearbeiten]
aDate day => day (1..31)
aDate month => month (1..12)
aDate year => year
- to retrieve date components.
Timestamp[Bearbeiten]
Timestamp instances represent a particular point in time. (i.e. "dd-mm-yyyy hh:mm:ss").
Creation[Bearbeiten]
Timestamp now => a timestamp
- provides the current timestamp
TimeDuration[Bearbeiten]
Timeduration instances represent a time-delta. (i.e. seconds).
