Support metapath date, date/time, and time extraction functions

[david-waltermire]

User Story

As a Metapath expression author, I need support for Metapath functions that extract information from date, date/time, and time values.

Goals

Implement the following Metapath functions that operate on date, date/time, and time values:

• fn:year-from-dateTime Returns the year component of an xs:dateTime.
• fn:month-from-dateTime Returns the month component of an xs:dateTime.
• fn:day-from-dateTime Returns the day component of an xs:dateTime.
• fn:hours-from-dateTime Returns the hours component of an xs:dateTime.
• fn:minutes-from-dateTime Returns the minute component of an xs:dateTime.
• fn:seconds-from-dateTime Returns the seconds component of an xs:dateTime.
• fn:timezone-from-dateTime Returns the timezone component of an xs:dateTime.
• fn:year-from-date Returns the year component of an xs:date.
• fn:month-from-date Returns the month component of an xs:date.
• fn:day-from-date Returns the day component of an xs:date.
• fn:timezone-from-date Returns the timezone component of an xs:date.
• fn:hours-from-time Returns the hours component of an xs:time.
• fn:minutes-from-time Returns the minutes component of an xs:time.
• fn:seconds-from-time Returns the seconds component of an xs:time.
• fn:timezone-from-time Returns the timezone component of an xs:time.

Dependencies

none

Acceptance Criteria

• All website and readme documentation affected by the changes in this issue have been updated.
• A Pull Request (PR) is submitted that fully addresses the goals of this User Story. This issue is referenced in the PR.
• The CI-CD build process runs without any reported errors on the PR. This can be confirmed by reviewing that all checks have passed in the PR.

Revisions

No response

[aj-stein-gsa]

@david-waltermire, just to be clear, am I doing the "simpler" or do we want these functions at this time to support the full 9.8.4 section of the spec re datetime formatting and the five-argument variants as well?

[david-waltermire]

@david-waltermire, just to be clear, am I doing the "simpler" or do we want these functions at this time to support the full 9.8.4 section of the spec re datetime formatting and the five-argument variants as well?

I think we want to get to the full support. This can be done in two PRs: 1) simple 2) full.

How do you want to approach this?

[david-waltermire]

@david-waltermire, just to be clear, am I doing the "simpler" or do we want these functions at this time to support the full 9.8.4 section of the spec re datetime formatting and the five-argument variants as well?

The functions here are about extracting information from dates/times. Are you referring to issue #283 here?

[aj-stein-gsa]

Woops yes sorry I had multiple tabs open and write things up in a text editor, then copy paste. I've been burned before with losing much longer and annoying issue and comment write-up's.

[david-waltermire]

@aj-stein-gsa Should we push this issue to a 2.3.0 release, to get the 2.2.0 out sooner?

[aj-stein-gsa]

I'm ok with that if you are.

[david-waltermire]

Let's knock these out in 2.2.0, since they should be quick to create.