<!--
{
  "availability" : [

  ],
  "documentType" : "symbol",
  "framework" : "SiriKitCloudMedia",
  "identifier" : "/documentation/SiriKitCloudMedia/DateComponents",
  "metadataVersion" : "0.1.0",
  "role" : "Type",
  "symbol" : {
    "kind" : "Type",
    "modules" : [
      "SiriKit Cloud Media"
    ],
    "preciseIdentifier" : "data:sirikit_media_api:DateComponents"
  },
  "title" : "DateComponents"
}
-->

# DateComponents

A full or partial date and time.

```
* DateComponents
```

## Discussion

The client may provide an [`ExplicitDateComponents`](/documentation/SiriKitCloudMedia/ExplicitDateComponents) object or represent a Gregorian date in one of the following formats:

|Description           |Format                                   |Example                   |
|----------------------|-----------------------------------------|--------------------------|
|Year only             |`string` (pattern: `/[0-9]{4}/)`         |`1984`                    |
|Year and month        |`string`  (pattern:`/[0-9]{4}-[0-9]{2}/)`|`1984-01`                 |
|Full date without time|`date`                                   |`1984-01-22`              |
|Date and time         |`date-time`                              |`1984-01-22T01:23:45.678Z`|

---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)