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 Sunday
[(time {now} "%a")] Weekday Short Sun
[(time {now} "%B")] Month Name December
[(time {now} "%b")] Month Name ShortDec
[(time {now} "%c")] Date and TimeSun Dec 9 16:53:42 2018
[(time {now} "%d")] Day of Month 01-3109
[(time {now} "%H")] Hour 00-24 16
[(time {now} "%I")] Hour 00-12 04
[(time {now} "%M")] Minute 53
[(time {now} "%m")] Month 01-12 12
[(time {now} "%S")] Second 42
[(time {now} "%U")] Week number, starting from the first Sunday 49
[(time {now} "%W")] Week number, starting from the first Monday 49
[(time {now} "%w")] Weekday, Sunday being 00
[(time {now} "%X")] WhatTimeIsIt 16:53:42
[(time {now} "%x")] WhatDayIsIt 12/09/18
[(time {now} "%Y")] Year 2018
[(time {now} "%y")] Year Short18
[(time {now} "%Z")] Time zone CST
[(time {now} "%Y %y %m%d %H:%M:%S")] Mix 2018 18 1209 16:53:42
[(time {now} "%Y-%m-%d")]International date format2018-12-09

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: Mon Dec 10 00:00:00 2018 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');