GetItemDateTime
PowerScript function
Syntax 1: GetItemDateTime ( ItemHandle )
Syntax 2: GetItemDateTime ( ParentItemHandle, Key )
Syntax 3: GetItemDateTime ( ItemPath )
Syntax 1
Description
Gets the value of the item whose type is datetime.
Applies to
Syntax
|
1 |
objectname.GetItemDateTime ( ItemHandle ) |
|
Argument |
Description |
|---|---|
|
objectname |
The name of the JSONParser object whose item value you |
|
ItemHandle |
A long whose value is the handle of the item of |
Return value
DateTime.
Returns the datetime value of the item if it succeeds; if any
argument’s value is null, returns null; if an error occurs, the
SystemError event will be triggered.
If the item value is a number (UTC timestamp), the returned
datetime value will be the local datetime converted by using the local
timezone. If the item value is a string, the returned datetime value
will be the datetime without timezone conversion.
Usage
If the item value is null, this function will throw an error,
therefore, it is recommended that before executing this function, call
GetItemType to check if the item
value is null. See example
2 in GetItemArray.
Examples
This example gets the value of the first item:
|
1 2 3 4 5 6 7 8 9 10 11 12 |
JsonParser lnv_JsonParser String ls_Json DateTime ldt_datetime Long ll_RootObject, ll_item lnv_JsonParser = Create JsonParser ls_Json = '{"datetime":7234930293, "date": "2017-09-21", "time": "12:00:00"}' lnv_JsonParser.LoadString(ls_Json) ll_RootObject = lnv_JsonParser.GetRootItem() ll_item = lnv_JsonParser.GetChildItem(ll_RootObject, 1) ldt_datetime = lnv_JsonParser.GetItemDateTime(ll_item) |
Syntax 2
Description
Gets the value of the item whose type is datetime.
Applies to
Syntax
|
1 |
objectname.GetItemDateTime ( ParentItemHandle, Key ) |
|
Argument |
Description |
|---|---|
|
objectname |
The name of the JSONParser object whose child item value |
|
ParentItemHandle |
A long whose value is the handle of the parent item of |
|
Key |
A string whose value is the key of the child item of |
Return value
DateTime.
Returns the datetime value of the child item if it succeeds; if
any argument’s value is null, returns null; if an error occurs, the
SystemError event will be triggered.
If the item value is a number (UTC timestamp), the returned
datetime value will be the local datetime converted by using the local
timezone. If the item value is a string, the returned datetime value
will be the datetime without timezone conversion.
Usage
If the item value is null, this function will throw an error,
therefore, it is recommended that before executing this function, call
GetItemType to check if the item
value is null. See example
2 in GetItemArray.
Examples
This example gets the value of the “datetime” item:
|
1 2 3 4 5 6 7 8 9 10 11 |
JsonParser lnv_JsonParser String ls_Json DateTime ldt_datetime Long ll_RootObject lnv_JsonParser = Create JsonParser ls_Json = '{"datetime":7234930293, "date": "2017-09-21", "time": "12:00:00"}' lnv_JsonParser.LoadString(ls_Json) ll_RootObject = lnv_JsonParser.GetRootItem() ldt_datetime = lnv_JsonParser.GetItemDateTime(ll_RootObject, "datetime") |
Syntax 3
Description
Gets the value of the item whose type is datetime.
Applies to
Syntax
|
1 |
objectname.GetItemDateTime ( ItemPath ) |
|
Argument |
Description |
|---|---|
|
objectname |
The name of the JSONParser object whose item value you |
|
ItemPath |
A string whose value is the path of the item of |
Return value
DateTime.
Returns the datetime value of the item if it succeeds; if any
argument’s value is null, returns null; if an error occurs, the
SystemError event will be triggered.
If the item value is a number (UTC timestamp), the returned
datetime value will be the local datetime converted by using the local
timezone. If the item value is a string, the returned datetime value
will be the datetime without timezone conversion.
Usage
If the item value is null, this function will throw an error,
therefore, it is recommended that before executing this function, call
GetItemType to check if the item
value is null. See example
2 in GetItemArray.
Examples
This example gets the value of the first item according to its
item path:
|
1 2 3 4 5 6 7 8 9 10 |
JsonParser lnv_JsonParser String ls_Json, ls_Path DateTime ldt_datetime lnv_JsonParser = Create JsonParser ls_Json = '{"datetime":7234930293, "date": "2017-09-21", "time": "12:00:00"}' lnv_JsonParser.LoadString(ls_Json) ls_Path = "/datetime" ldt_datetime = lnv_JsonParser.GetItemDateTime(ls_Path) |
See also