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 Wednesday
[(time {now} "%a")] Weekday Short Wed
[(time {now} "%B")] Month Name November
[(time {now} "%b")] Month Name ShortNov
[(time {now} "%c")] Date and TimeWed Nov 13 12:26:01 2019
[(time {now} "%d")] Day of Month 01-3113
[(time {now} "%H")] Hour 00-24 12
[(time {now} "%I")] Hour 00-12 12
[(time {now} "%M")] Minute 26
[(time {now} "%m")] Month 01-12 11
[(time {now} "%S")] Second 01
[(time {now} "%U")] Week number, starting from the first Sunday 45
[(time {now} "%W")] Week number, starting from the first Monday 45
[(time {now} "%w")] Weekday, Sunday being 03
[(time {now} "%X")] WhatTimeIsIt 12:26:01
[(time {now} "%x")] WhatDayIsIt 11/13/19
[(time {now} "%Y")] Year 2019
[(time {now} "%y")] Year Short19
[(time {now} "%Z")] Time zone CST
[(time {now} "%Y %y %m%d %H:%M:%S")] Mix 2019 19 1113 12:26:01
[(time {now} "%Y-%m-%d")]International date format2019-11-13

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: Thu Nov 14 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');