Values

This document describes the types of values that can be used in metadata key searches. There are three basic types of values: strings, numbers and dates.

Strings

Literal strings are surrounded by quotes. Both double(") and single(') quotes can be used to produce the same literal string. Double and single quotes do not terminate eachother, so they can be nested.

Examples:

"Hello world"

'Hello world'

"I said 'Hello world' to the world"

Numbers

Numbers can be written in one of several notations: integer, fixed point, floating point with exponentiation, and hexidecimal. Examples of each follow.

Integer:

0, 42, 128

Fixed point:

1.5, 2.71828

Floating point with exponentation:

9.2e-5

Hexidecial:

0x7, 0xff, 0xBEEF

Dates

Dates can be expressed using one of the following date constants:

$time.today

$time.yesterday

$time.this_week

$time.this_month

$time.this_year

You can build upon these constants by using offsets. Offsets are integers which change the date of the constant by adding or substracting a specified number of time units. The time unit used is based on the constant used. For example $time.this_week is offset by weeks, while $time.this_month is offset by months. Some examples of using date offsets:

Two months ago:

$time.this_month(-2)

Next week:

$time.this_week(1)

Tomorrow:

$time.today(1)