Period

A time period with a start and end date/time - used to represent validity periods, date ranges, time intervals, and temporal boundaries

10 properties
Schema

Properties

PropertyTypeModeDescriptionRequired
startdatetime
stored

Start date/time of the period (inclusive)

Example: "2024-01-01T00:00:00Z"

Optional
enddatetime
stored

End date/time of the period (inclusive)

Example: "2024-12-31T23:59:59Z"

Optional
durationnumber
calculated

Duration in milliseconds between start and end dates

Optional
durationDaysnumber
calculated

Total number of calendar days in the period (inclusive)

Optional
durationHoursnumber
calculated

Total number of hours in the period

Optional
businessDaysnumber
calculated

Number of business days (Monday-Friday) in the period, excluding weekends

Optional
weekendDaysnumber
calculated

Number of weekend days (Saturday-Sunday) in the period

Optional
isActiveboolean
calculated

Whether the period is currently active (current date/time is between start and end)

Optional
hasStartedboolean
calculated

Whether the period has already started

Optional
hasEndedboolean
calculated

Whether the period has already ended

Optional

Examples

Example 1

{
  "@type": "Period",
  "start": "2024-01-01T00:00:00Z",
  "end": "2024-12-31T23:59:59Z"
}

Example 2

{
  "@type": "Period",
  "start": "2024-06-01T09:00:00Z",
  "end": "2024-06-01T17:00:00Z"
}

Example 3

{
  "@type": "Period",
  "start": "2023-01-01T00:00:00Z"
}

Example 4

{
  "@type": "Period",
  "end": "2024-12-31T23:59:59Z"
}