FORGEBOX Enterprise 🚀 - Take your ColdFusion (CFML) Development to Modern Times! Learn More...

Date Utility

v1.0.2 Public

Date Utility

Master Branch Build Status

This is a ColdBox Module to assist in dealing with dates, especially converting between timezones and formatting for data transfer.


  • Lucee 5+ or Adobe ColdFusion 10+
  • ColdBox 4.3+
  • Java 8+


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"


Use dateutil.isValidDate("2018-06-50") to see if June 50th, 2018 is valid. Similarly, 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: tests/specs/TestDateUtility.cfc API documentation can be generated easily. See docs/ 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.

Version Created Last Update Published By Stable Actions
1.0.2 Aug 29 2018 03:59 PM Aug 29 2018 03:59 PM
Version History
1.0.1 Jul 24 2018 10:31 AM Jul 24 2018 10:31 AM
1.0.0 Jun 17 2018 11:24 PM Jun 17 2018 11:24 PM


No collaborators yet.
  • Jun 17 2018 11:24 PM
  • Aug 29 2018 03:59 PM
  • 444
  • 0
  • 512