AddItemDateTime

Description

Adds the child item of JsonStringItem or JsonNumberItem type in the JSON generator object.

Applies to

JSONGenerator objects

Syntax

objectname.AddItemDateTime ( ParentItemHandle, Value )
objectname.AddItemDateTime ( ParentItemHandle, Value, Flag )
objectname.AddItemDateTime ( ParentItemHandle, Key, Value )
objectname.AddItemDateTime ( ParentItemHandle, Key, Value, Flag )

Argument

Description

objectname

The name of the JSONGenerator object in which you want to add an item.

ParentItemHandle

A long whose value is the handle of the parent item of JsonArrayItem or JsonObjectItem type.

Key

A string whose value is the key of the child item.

Value

A datetime whose value is the value of the child item.

Flag

A boolean whose value is the type of the child item.

True -- JsonNumberItem type. A JsonNumberItem type value is a UTC timestamp converted from the local time using the local timezone.

False -- JsonStringItem type. A JsonStringItem type value is a string converted from the local time directly (no timezone conversion).


Return value

Long.

Returns the handle of the new child item if it succeeds and -1 if an error occurs. If any argument's value is null, the method returns null.

Example 1

This example creates an array root item and adds a DateTime child item. The result is ["2017-12-09 12:15:00"].

JsonGenerator lnv_JsonGenerator
lnv_JsonGenerator = Create JsonGenerator

// Create an array root item
Long ll_RootArray = lnv_JsonGenerator.CreateJsonArray()

// Add a DateTime child item
lnv_JsonGenerator.AddItemDateTime(ll_RootArray,  datetime("2017-12-09 12:15:00"))

Example 2

This example creates an array root item and adds a DateTime child item without timezone conversion. The result is ["2017-12-09 12:15:00"].

JsonGenerator lnv_JsonGenerator
lnv_JsonGenerator = Create JsonGenerator

// Create an array root item
Long ll_RootArray = lnv_JsonGenerator.CreateJsonArray()

// Add a DateTime child item
lnv_JsonGenerator.AddItemDateTime(ll_RootArray, datetime("2017-12-09 12:15:00"), false)
//Result is ["2017-12-09 12:15:00"]

//lnv_JsonGenerator.AddItemDateTime(ll_RootArray, datetime("2017-12-09 12:15:00"), true)
//Result is [1512821700]

Example 3

This example creates an object root item and adds a DateTime child item. The result is {"datetime":"2017-12-09 12:15:00"}.

JsonGenerator lnv_JsonGenerator
lnv_JsonGenerator = Create JsonGenerator

// Create an object root item
Long ll_RootObject = lnv_JsonGenerator.CreateJsonObject ()

// Add a DateTime child item
lnv_JsonGenerator.AddItemDateTime(ll_RootObject, "datetime", datetime("2017-12-09 12:15:00"))

Example 4

This example creates an object root item and adds a DateTime child item using the local timezone conversion. The result is {"datetime":1512821700}.

JsonGenerator lnv_JsonGenerator
lnv_JsonGenerator = Create JsonGenerator

// Create an object root item
Long ll_RootObject = lnv_JsonGenerator.CreateJsonObject ()

// Add a DateTime child item
lnv_JsonGenerator.AddItemDateTime(ll_RootObject, "datetime", datetime("2017-12-09 12:15:00"), true)

See also

AddItemArray

AddItemBlob

AddItemBoolean

AddItemDate

AddItemNull

AddItemNumber

AddItemObject

AddItemString

AddItemTime