adlnet / xapi-profiles

A set of documents addressing the structure of and supporting services for xAPI Profiles.
https://adlnet.gov/projects/xapi/
Apache License 2.0
54 stars 27 forks source link

xAPI Profiles 2.0 / Alignment to xAPI 2.0: Timestamps #269

Open imartinezortiz opened 1 month ago

imartinezortiz commented 1 month ago

Change Log Item Ids

s19, s20, s22

1.0.3 text -> 9274.1.1 Update

A Timestamp SHOULD* be expressed using the format described in RFC 3339, which is a profile of ISO 8601 -> A Timestamp shall be expressed using the format described in RFC 3339, which is a profile of ISO 8601.

A Timestamp SHOULD* include the time zone. -> Removed as requirement

The LRS SHOULD* return the Timestamp in UTC timezone. -> An LRS shall convert Timestamps to UTC rather than rejecting Statements that send Timestamps not in UTC form

Updates to xAPI Profile spec

References to consider

This issue has been migrated from: https://github.com/FeLungs/xapi-profiles/issues/7

imartinezortiz commented 1 month ago

@Felungs comment:

Overall, I think we should go with dateTimeStamp over dateTime because xAPI doesn't support timestamp without timezone or offset which IMO makes dateTimeStamp more correct than dateTime

dateTime

dateTimeStamp

The dateTimeStamp datatype is ·derived· from dateTime by giving the value required to its explicitTimezone facet. The result is that all values of dateTimeStamp are required to have explicit time zone offsets and the datatype is totally ordered.

Both XSD types have differences from RFC 3339 but that can be accounted for within normative language. (example within explanation section of https://validator.w3.org/feed/docs/error/InvalidRFC3339Date.html)

https://www.w3.org/2011/rdf-wg/wiki/XSD_Datatypes

andyjohnson commented 1 month ago

WG Notes - Oct 24, 2024 -

1) Note that the current rfc is 9557 not 3339 as of April 2024 2) IEEE xAPI refers to 3339 3) Can review 9557 and look for changes 4) Recommend the timestamp property follows the xAPI timestamp in both the profile specification or JSON-LD