SupportArea

BoltWire is a FREE content management system written in PHP.

Its innovative architecture combined with best-in-class forms processing makes it ideal for creating complex, interactive, web applications fast...


Documentation

Markups
Variables
Conditions
Functions
Forms
Commands
Cheatsheet

Documentation

Tutorials > Time

BoltWire's time function/command taps directly into both the strtotime and strftime functions in PHP (strtotime allows you to enter time values like "Tomorrow" or " 3 hours" and it will automatically convert it to the appropriate timestamp; strftime allows you to take that timestamp and display it in various formats, as desired).

Listed below are some of the possible formatting options -- though the output of some will vary from server to server depending on your PHP configuration. For a complete discussion, please refer to the PHP manual.

SyntaxMeaningOutput Sample
[(time {now} "%A")] Weekday Friday
[(time {now} "%a")] Weekday Short Fri
[(time {now} "%B")] Month Name April
[(time {now} "%b")] Month Name ShortApr
[(time {now} "%c")] Date and TimeFri Apr 19 04:08:19 2019
[(time {now} "%d")] Day of Month 01-3119
[(time {now} "%H")] Hour 00-24 04
[(time {now} "%I")] Hour 00-12 04
[(time {now} "%M")] Minute 08
[(time {now} "%m")] Month 01-12 04
[(time {now} "%S")] Second 19
[(time {now} "%U")] Week number, starting from the first Sunday 15
[(time {now} "%W")] Week number, starting from the first Monday 15
[(time {now} "%w")] Weekday, Sunday being 05
[(time {now} "%X")] WhatTimeIsIt 04:08:19
[(time {now} "%x")] WhatDayIsIt 04/19/19
[(time {now} "%Y")] Year 2019
[(time {now} "%y")] Year Short19
[(time {now} "%Z")] Time zone CDT
[(time {now} "%Y %y %m%d %H:%M:%S")] Mix 2019 19 0419 04:08:19
[(time {now} "%Y-%m-%d")]International date format2019-04-19

Examples

Here is a simple snippet illustrating the new, very powerful, time command. Try entering a time string like "tomorrow" or " 2 months", or a format like "%c" or %x", or both, with a pipe in the middle, like "today|%x". For more details see php documentation for the strtotime and strftime functions.


[form]
[text time][submit]
[command warn "{=time}"]
[form]

Here is something perhaps more useful. Suppose you need a timestamp (e.g. for an unique url of the page you create) and want also store this same timestamp in another format (e.g. human readable to display) as a data value, you can do this in your form:


[form]
Timestamp: [text when {now}]
[submit]
[command target "examplepage.{=when}"]
[command time "{=when}|%m/%d/%Y"]
[command savedata time]
[form]

Of course {:time} could be produced just as easily by saving when and doing [(time {:when} '%m/%d/%Y')].

Here are some ways to handle due dates:


Days until next year: [(time "Jan 1, 2010" due)] days.

Tomorrow starts in: [(time "tomorrow" due=3600)] hours.

Days until next year: Fri Jan 1 00:00:00 2010 days.

Tomorrow starts in: Sat Apr 20 00:00:00 2019 hours.


International


If you want to change the time output to your local environment, try add the following line to your index.php file before including the engine (here for Germany):

setlocale (LC_TIME,'de_DE');