Date
Calendar and date handling
operations like addition and subtraction of days, months, and years, ensuring accurate handling of various date-related complexities such as leap years and month-end calculations
Import
_ <- fat.extra.Date
time library, math library, Error type, Text type, List type, Number type, Duration type are automatically imported with this import
Date Type
Date offers a comprehensive solution for managing dates, including leap years and time of day.
Properties
year: Number - Year of the datemonth: Number - Month of the dateday: Number - Day of the datetms: Millis - Time of the day in milliseconds
default value points to: 1 of January of 1970
Prototype Members
| Name | Signature | Brief |
|---|---|---|
| fromEpoch | (ems: Epoch): Date | Creates a Date instance from an epoch time |
| isLeapYear | (year: Number): Boolean | Determines if a year is a leap year |
| normalizeMonth | (month: Number): Number | Normalizes the month number |
| daysInMonth | (year: Number, month: Number): Number | Returns number of days in month of year |
| isValid | (year, month, day, tms): Boolean | Validates the date components |
| truncate | (): Date | Truncates the time of day |
| toEpoch | (): Epoch | Converts the Date instance to epoch time |
| addYears | (yearsToAdd: Number): Date | Adds years to the date |
| addMonths | (monthsToAdd: Number): Date | Adds months to the date |
| addWeeks | (weeksToAdd: Number): Date | Adds weeks to the date |
| addDays | (daysToAdd: Number): Date | Adds days to the date |
Usage Examples
_ <- fat.extra.Date
# Create a Date instance
myDate = Date(2023, 1, 1)
# Add one year to the date
newDate = myDate.addYears(1)
# Add two weeks to a date
datePlusTwoWeeks = myDate.addWeeks(2)
# Create a Date from epoch time (in milliseconds)
# result is influenced by current timezone, see: time.setZone
epochTime = 1672531200000
dateFromEpoch = Date.fromEpoch(Epoch(epochTime))
# Convert a date to epoch time
epochFromDate = myDate.toEpoch