31 lines
2.1 KiB
Plaintext
31 lines
2.1 KiB
Plaintext
caption: format
|
|
created: 20201020100834443
|
|
modified: 20230321132245053
|
|
op-input: a [[selection of titles|Title Selection]]
|
|
op-output: input strings formatted according to the specified suffix <<.place B>>
|
|
op-parameter: optional format string for the formats
|
|
op-parameter-name: C
|
|
op-purpose: format the input string according to one of supported formats
|
|
op-suffix: one of supported formats
|
|
op-suffix-name: B
|
|
tags: [[Filter Operators]] [[String Operators]]
|
|
title: format Operator
|
|
type: text/vnd.tiddlywiki
|
|
|
|
<<.from-version "5.1.23">>
|
|
|
|
The suffix <<.place B>> is one of the following supported string formats:
|
|
|
|
|Format |Description |h
|
|
|^`date` |The input string is interpreted as a UTC date and displayed according to the DateFormat specified in the optional parameter <<.place C>>. (Defaults to "YYYY MM DD 0hh:0mm") |
|
|
|^`json` |<<.from-version "5.2.4">> The input string is interpreted as JSON and displayed with standard formatting. The optional parameter <<.place C>> specifies the number of spaces to use for indenting, or a string to use for indenting. Nothing is returned if the input string is not valid JSON |
|
|
|^`relativedate` |The input string is interpreted as a UTC date and displayed as the interval from the present instant. Any operator parameters <<.place C>> are ignored |
|
|
|^`timestamp` |<<.from-version "5.3.0">> The input string is interpreted as number of milliseconds since the [[ECMAScript epoch|https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date#the_ecmascript_epoch_and_timestamps]], 1 January 1970, and displayed according to the DateFormat specified in the optional operator parameter. (Defaults to "[UTC]YYYY0MM0DD0hh0mm0ss0XXX") |
|
|
|^`titlelist` |<<.from-version "5.2.0">> The input string wrapped in double square brackets if it contains a space. Appropriate for use in a [[title list|Title List]]. |
|
|
|
|
Invalid input strings are dropped by the <<.op format>> operator.
|
|
|
|
<<.warning """The [[Title List]] format cannot reliably represent items that contain certain specific character sequences such as `]] `. Thus it should not be used where there is a possibility of such sequences occurring.""">>
|
|
|
|
<<.operator-examples "format">>
|