DateTime - schema.org

# schema.org

- Documentation
- Schemas
- Home

# DateTime

####

A combination of date and time of day in the form [-]CCYY-MM-DDThh:mm:ss[Z|(+|-)hh:mm] (see Chapter 5.4 of ISO 8601).
Usage: Between 10 and 100 domains
[more...]

- Leave public feedback on this term 💬
- Check for open issues.
- 'DateTime' is mentioned in layer: core
- 'DateTime' is mentioned in extension layer: pending

Instances of DateTime may appear as values for the following properties

Property | On Types | Description
--- | --- | ---
`arrivalTime` | BusTrip or Flight or TrainTrip | The expected arrival time.
`availabilityEnds` | Demand or Offer | The end of the availability of the product or service included in the offer.
`availabilityStarts` | Demand or Offer | The beginning of the availability of the product or service included in the offer.
`availableFrom` | DeliveryEvent | When the item is available for pickup from the store, locker, etc.
`availableThrough` | DeliveryEvent | After this date, the item will no longer be available for pickup.
`bookingTime` | Reservation | The date and time the reservation was booked.
`checkinTime` | LodgingReservation | The earliest someone may check into a lodging establishment.
`checkoutTime` | LodgingReservation | The latest someone may check out of a lodging establishment.
`coverageEndTime` | LiveBlogPosting | The time when the live blog will stop covering the Event. Note that coverage may continue after the Event concludes.
`coverageStartTime` | LiveBlogPosting | The time when the live blog will begin covering the Event. Note that coverage may begin before the Event's start time. The LiveBlogPosting may also be created before coverage begins.
`datasetTimeInterval` | Dataset | The range of temporal applicability of a dataset, e.g. for a 2011 census dataset, the year 2011 (in ISO 8601 time interval format). Supersedes temporal.
`dateCreated` | CreativeWork or DataFeedItem | The date on which the CreativeWork was created or the item was added to a DataFeed.
`dateDeleted` | DataFeedItem | The datetime the item was removed from the DataFeed.
`dateIssued` | Ticket | The date the ticket was issued.
`dateModified` | CreativeWork or DataFeedItem | The date on which the CreativeWork was most recently modified or when the item's entry was modified within a DataFeed.
`dateRead` | Message | The date/time at which the message has been read by the recipient if a single recipient exists.
`dateReceived` | Message | The date/time the message was received if a single recipient exists.
`dateSent` | Message | The date/time at which the message was sent.
`departureTime` | BusTrip or Flight or TrainTrip | The expected departure time.
`doorTime` | Event | The time admission will commence.
`dropoffTime` | RentalCarReservation | When a rental car can be dropped off.

`endTime`

Action or
FoodEstablishmentReservation

The endTime of something. For a reserved event or service (e.g. FoodEstablishmentReservation), the time that it is expected to end. For actions that span a period of time, when the action was performed. e.g. John wrote a book from January to December.

Note that Event uses startDate/endDate instead of startTime/endTime, even when describing dates with times. This situation may be clarified in future revisions.

`expectedArrivalFrom` | ParcelDelivery | The earliest date the package may arrive.
`expectedArrivalUntil` | ParcelDelivery | The latest date the package may arrive.
`modifiedTime` | Reservation | The date and time the reservation was modified.
`orderDate` | Order | Date order was placed.
`ownedFrom` | OwnershipInfo | The date and time of obtaining the product.
`ownedThrough` | OwnershipInfo | The date and time of giving up ownership on the product.
`paymentDueDate` | Invoice or Order | The date that payment is due. Supersedes paymentDue.
`pickupTime` | RentalCarReservation or TaxiReservation | When a taxi will pickup a passenger or a rental car can be picked up.
`scheduledTime` | PlanAction | The time the object is scheduled to.

`startTime`

Action or
FoodEstablishmentReservation

The startTime of something. For a reserved event or service (e.g. FoodEstablishmentReservation), the time that it is expected to start. For actions that span a period of time, when the action was performed. e.g. John wrote a book from January to December.

Note that Event uses startDate/endDate instead of startTime/endTime, even when describing dates with times. This situation may be clarified in future revisions.

`validFrom`

Demand or
MonetaryAmount or
Offer or
OpeningHoursSpecification or
Permit or
PriceSpecification

The date when the item becomes valid.

`validThrough`

Demand or
JobPosting or
MonetaryAmount or
Offer or
OpeningHoursSpecification or
PriceSpecification

The date after when the item is not valid. For example the end of an offer, salary period, or a period of opening hours.

`webCheckinTime` | Flight | The time when a passenger can check into the flight online.

Schema Version 3.0