FORGEBOX Enterprise 🚀 - Take your ColdFusion (CFML) Development to Modern Times! Learn More...
This is a ColdBox Module to assist in dealing with dates, especially converting between timezones and formatting for data transfer.
Install using CommandBox:
box install date-utility
Get an instance of DateUtility from WireBox:
property name="dateutil" inject="[email protected]";
There are several examples in the test specification that might be helpful to browse.
If you have a date and know its timezone, you can get the seconds/milliseconds since the Epoch:
dateutil.getEpochSecondsUsingPattern("2018-03-11 01:30: 00", "US/Pacific"); // Returns 1520760600 dateutil.getEpochMillisUsingPattern("2018-03-11 01:30: 00.050", "US/Pacific"); // Returns 1520760600050
If you have the number of seconds/milliseconds since the Epoch, and you'd like to express it as an ISO 8601 string:
dateutil.formatEpochSeconds(1523830577, "UTC", "ISO_8601_ZULU"); // Returns "2018-04-15T22:16: 17Z" dateutil.formatEpochMillis(1523830577123, "UTC", "ISO_8601_FRACTIONAL_ZULU"); // Returns "2018-04-15T22:16: 17.123Z"
dateutil.isValidDate("2018-06-50") to see if June 50th, 2018 is valid.
dateutil.isValidDatetime("2018-06-05 14:65: 00") indicates that 2:65 in the afternoon isn't reasonable.
There are several usage examples in the test spec:
API documentation can be generated easily. See
docs/README.md for instructions.
See the LICENSE file for license rights and limitations (MIT).
Here are all the versions for this package. Please note that you can leverage CommandBox package versioning to install any package you like. Please refer to our managing package version guide for more information.