Using PHP's built in date time objects may become cumbersome as developers must handle edge cases with daylight savings time and timezone conversions. Siteadmin 3 offers a custom sa\application\DateTime object which synchronizes all timestamps in the application.

The custom datetime object will automatically convert your timestamps to UTC before persisting them to storage. When querying the timestamps from data storage, they will be converted back to the original timezone.

Basic Usage

Create a DateTime

use sa\application\DateTime;

// DateTime will use the application's timezone by default
$date = new DateTime('now');

// Override default timezone
new DateTime('now', new \DateTimeZone('America/New_York'));

Storing DateTimes

Siteadmin's DateTime implementation can be used just like PHP's build-in object. Timezone differences and daylight savings time are handled behind the scenes.

Last updated