TimePeriod

November 2, 2023 · View on GitHub

Smart Data Models

TimePeriod

Version: 0.0.1

Description

This Resource describes the time period over which any additionally provided information is derived or bounded.The Property 'startTime' and 'stopTime' are RFC3339 encoded strings. The Property 'startTime' must be present.The interval is the interval of the time period in minutes, if present this value must be no less than 0 minute.The intervalsecond is the interval of the time period in seconds, if present this value must be numerical zero or greater.The repeat is the number of the time period's iteration, which means how many times to repeat the time period. The Property 'repeat' accepts only negative one, numerical zero, and positive number. When this value is numerical zero, the time period will be repeated infinitely until a client makes it stop by inputting negative one for the value.The Property 'stoptime' and 'interval' are mutually exclusive; both Properties cannot be present in a Resource instance.The Property 'intervalsecond' cannot be presented with the Property 'stopTime'. In case of both the Property 'interval' and 'intervalsecond' are presented together, the total time interval is the sum of 'interval' and 'intervalsecond'.The Property 'triggertiming' describes a specific time to execute an action. This property must have one of the values among 'startTime', 'stopTime', and 'totalInterval'. The totalInterval means the sum of the Property 'interval' and 'intervalsecond'. If one of the properties does not exist, the value of the unexpressed property is taken as a numerical zero.The Property 'state' describes a state of time interval. This property must have one of the values among 'preInterval', 'inInterval', and 'postInterval'.The Resource defines a time period for information retrieval, action or other behaviour.

Data Model adapted from the original created by the Open Connectivity Foundation. Original repository in https://github.com/openconnectivityfoundation/IoTDataModels

Specification

Link to the interactive specification

Link to the specification

Enlace a la Especificación en español

Lien vers le spécification en français

Link zur deutschen Spezifikation

Link alla specifica

仕様へのリンク

链接到规范

사양 링크

Examples

Link to the example (keyvalues) for NGSI v2

Link to the example (keyvalues) for NGSI-LD

Link to the example (normalized) for NGSI-V2

Link to the example (normalized) for NGSI-LD

Link to the example (keyvalues) for NGSI v2 in CSV format

Link to the example (keyvalues) for NGSI-LD in CSV format

Link to the example (normalized) for NGSI-V2 in CSV format

Link to the example (normalized) for NGSI-LD in CSV format

Dynamic Examples generation

Link to the Generator of NGSI-LD normalized payloads compliant with this data model. Refresh for new values

Link to the Generator of NGSI-LD keyvalues payloads compliant with this data model. Refresh for new values

Link to the Generator of geojson feature format payloads compliant with this data model. Refresh for new values

PostgreSQL schema

Link to the PostgreSQL schema of this data model

Contribution

If you have any issue on this data model you can raise an issue or contribute with a PR

If you wish to develop your own data model you can start from contribution manual. Several services have been developed to help with: