NAME¶
bson_append_date_time() - The bson_append_date_time() function shall append a
new element to a bson document containing a date and time with no timezone
information. value is assumed to be in UTC format of milliseconds since the
UNIX epoch. value MAY be negative.
SYNOPSIS¶
bool
bson_append_date_time (bson_t *bson,
const char *key,
int key_length,
int64_t value);
PARAMETERS¶
- bson
- A bson_t
- key
- An ASCII C string containing the name of the field.
- key_length
- The length of key in bytes, or ‐1 to determine the length
with strlen(3)
- value
- The date and time as specified in milliseconds since the UNIX epoch.
DESCRIPTION¶
The bson_append_date_time(3) function shall append a new element to a
bson document containing a date and time with no timezone information.
value is assumed to be in UTC format of milliseconds since the UNIX
epoch. value
MAY be negative.
RETURNS¶
true if the operation was applied successfully, otherwise false and bson
should be discarded.