{time}

Quick Overview Video

Settings

Time/Date Formatting

Text Blaze's time/date formatting syntax allows you to customize the output of your times and dates in various ways. It allows you to mix formatting with tokens that have special meanings.

For example, one way the current date could be entered is MMM Do, YYYY (resulting in the output of Nov 13th, 2017), and the current time could be specified with h:mm (resulting in the output of 11:24).

Text Blaze's time/date formatting syntax is based on Moment, a JavaScript library for parsing and formatting dates.

The following table (adapted from the Moment.js documentation website) contains the full list of support tokens:

Setting the Time/Date

The optional at setting allows you to specify the time/date used by the time command. If the at setting is not explicitly set, the current time/date will be used.

The at setting will interpret many common date formats. If the at format does not recognize your date format, or your date format is ambiguous, or you want to specify a time; you can use the pattern setting to tell Text Blaze how to understand your date.

The pattern setting uses the Text Blaze time/date formatting syntax to tell Text Blaze how your time/date is structured.

For example, if your date was 2000-01-01 where you have Year-Month-Day, you would use a pattern of YYYY-MM-DD. If your date was instead Year-Day-Month, you could use the pattern YYYY-DD-MM.

Time/Date Shifting

The optional shift setting lets you display a time/date in either the future or past. A time shift is specified to select a time period relative to the current time.

For example, to show the date 10 days from now, you could use {time: MMM Do, YYYY; shift=+10D}.

If the at setting is specified, any time shifts will be relative to that date.

Shifts are specified in terms of a base period like days or weeks. You can have a fixed shift like +2W (two weeks from the current time) or -5D (five days ago). You can also shift to the beginning or end of any standard date period. For example, <M will shift to the start of the current month, while >Y will shift to the end of the current year.

The following table summarizes the shifts relative to the standard periods.

You can also shift forward or backward to a specific day of the week. For example, >MON will shift forward to the nearest Monday. If the current date is a Monday, no shift will take place. <MON will shift backwards to the nearest Monday. Again, if the current date is a Monday, no shift will take place.

The following examples show how you might use date shifting to specify specific dates.

When shifting by days, you can skip certain days of the week. For example, if you wanted to shift 10 weekdays into the future you could use the following:

Locales and Localization

It's possible to override the locale for individual {time} commands using the locale setting.

If not specified, {time} command will attempt to use the locale specified in your Text Blaze account settings when formatting the time/date.

A list of available language locales are available in your Account Settings page under the Locale & Formatting header.