---
title: DateTime - Partner API
description: >-
  An [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) encoded UTC date time
  string. Example value: `"2019-07-03T20:47:55.123456Z"`.
api_version: 2025-01
api_name: partner
type: scalar
api_type: graphql
source_url:
  html: 'https://shopify.dev/docs/api/partner/2025-01/scalars/DateTime'
  md: 'https://shopify.dev/docs/api/partner/2025-01/scalars/DateTime.md'
---

# Date​Time

scalar

An [ISO-8601](https://en.wikipedia.org/wiki/ISO_8601) encoded UTC date time string. Example value: `"2019-07-03T20:47:55.123456Z"`.

## Map

### Fields with this scalar

* <-|[App​One​Time​Sale.createdAt](https://shopify.dev/docs/api/partner/2025-01/objects/AppOneTimeSale#field-AppOneTimeSale.fields.createdAt)
* <-|[App​Sale​Adjustment.createdAt](https://shopify.dev/docs/api/partner/2025-01/objects/AppSaleAdjustment#field-AppSaleAdjustment.fields.createdAt)
* <-|[App​Sale​Credit.createdAt](https://shopify.dev/docs/api/partner/2025-01/objects/AppSaleCredit#field-AppSaleCredit.fields.createdAt)
* <-|[App​Subscription.billingOn](https://shopify.dev/docs/api/partner/2025-01/objects/AppSubscription#field-AppSubscription.fields.billingOn)
* <-|[App​Subscription​Sale.createdAt](https://shopify.dev/docs/api/partner/2025-01/objects/AppSubscriptionSale#field-AppSubscriptionSale.fields.createdAt)
* <-|[App​Usage​Sale.createdAt](https://shopify.dev/docs/api/partner/2025-01/objects/AppUsageSale#field-AppUsageSale.fields.createdAt)
* <-|[Credit​Applied.occurredAt](https://shopify.dev/docs/api/partner/2025-01/objects/CreditApplied#field-CreditApplied.fields.occurredAt)
* <-|[Credit​Failed.occurredAt](https://shopify.dev/docs/api/partner/2025-01/objects/CreditFailed#field-CreditFailed.fields.occurredAt)
* <-|[Credit​Pending.occurredAt](https://shopify.dev/docs/api/partner/2025-01/objects/CreditPending#field-CreditPending.fields.occurredAt)
* <-|[Legacy​Transaction.createdAt](https://shopify.dev/docs/api/partner/2025-01/objects/LegacyTransaction#field-LegacyTransaction.fields.createdAt)
* <-|[One​Time​Charge​Accepted.occurredAt](https://shopify.dev/docs/api/partner/2025-01/objects/OneTimeChargeAccepted#field-OneTimeChargeAccepted.fields.occurredAt)
* <-|[One​Time​Charge​Activated.occurredAt](https://shopify.dev/docs/api/partner/2025-01/objects/OneTimeChargeActivated#field-OneTimeChargeActivated.fields.occurredAt)
* <-|[One​Time​Charge​Declined.occurredAt](https://shopify.dev/docs/api/partner/2025-01/objects/OneTimeChargeDeclined#field-OneTimeChargeDeclined.fields.occurredAt)
* <-|[One​Time​Charge​Expired.occurredAt](https://shopify.dev/docs/api/partner/2025-01/objects/OneTimeChargeExpired#field-OneTimeChargeExpired.fields.occurredAt)
* <-|[Referral​Adjustment.createdAt](https://shopify.dev/docs/api/partner/2025-01/objects/ReferralAdjustment#field-ReferralAdjustment.fields.createdAt)
* <-|[Referral​Transaction.createdAt](https://shopify.dev/docs/api/partner/2025-01/objects/ReferralTransaction#field-ReferralTransaction.fields.createdAt)
* <-|[Relationship​Deactivated.occurredAt](https://shopify.dev/docs/api/partner/2025-01/objects/RelationshipDeactivated#field-RelationshipDeactivated.fields.occurredAt)
* <-|[Relationship​Installed.occurredAt](https://shopify.dev/docs/api/partner/2025-01/objects/RelationshipInstalled#field-RelationshipInstalled.fields.occurredAt)
* <-|[Relationship​Reactivated.occurredAt](https://shopify.dev/docs/api/partner/2025-01/objects/RelationshipReactivated#field-RelationshipReactivated.fields.occurredAt)
* <-|[Relationship​Uninstalled.occurredAt](https://shopify.dev/docs/api/partner/2025-01/objects/RelationshipUninstalled#field-RelationshipUninstalled.fields.occurredAt)
* <-|[Service​Sale.createdAt](https://shopify.dev/docs/api/partner/2025-01/objects/ServiceSale#field-ServiceSale.fields.createdAt)
* <-|[Service​Sale​Adjustment.createdAt](https://shopify.dev/docs/api/partner/2025-01/objects/ServiceSaleAdjustment#field-ServiceSaleAdjustment.fields.createdAt)
* <-|[Subscription​Approaching​Capped​Amount.occurredAt](https://shopify.dev/docs/api/partner/2025-01/objects/SubscriptionApproachingCappedAmount#field-SubscriptionApproachingCappedAmount.fields.occurredAt)
* <-|[Subscription​Capped​Amount​Updated.occurredAt](https://shopify.dev/docs/api/partner/2025-01/objects/SubscriptionCappedAmountUpdated#field-SubscriptionCappedAmountUpdated.fields.occurredAt)
* <-|[Subscription​Charge​Accepted.occurredAt](https://shopify.dev/docs/api/partner/2025-01/objects/SubscriptionChargeAccepted#field-SubscriptionChargeAccepted.fields.occurredAt)
* <-|[Subscription​Charge​Activated.occurredAt](https://shopify.dev/docs/api/partner/2025-01/objects/SubscriptionChargeActivated#field-SubscriptionChargeActivated.fields.occurredAt)
* <-|[Subscription​Charge​Canceled.occurredAt](https://shopify.dev/docs/api/partner/2025-01/objects/SubscriptionChargeCanceled#field-SubscriptionChargeCanceled.fields.occurredAt)
* <-|[Subscription​Charge​Declined.occurredAt](https://shopify.dev/docs/api/partner/2025-01/objects/SubscriptionChargeDeclined#field-SubscriptionChargeDeclined.fields.occurredAt)
* <-|[Subscription​Charge​Expired.occurredAt](https://shopify.dev/docs/api/partner/2025-01/objects/SubscriptionChargeExpired#field-SubscriptionChargeExpired.fields.occurredAt)
* <-|[Subscription​Charge​Frozen.occurredAt](https://shopify.dev/docs/api/partner/2025-01/objects/SubscriptionChargeFrozen#field-SubscriptionChargeFrozen.fields.occurredAt)

### Arguments with this scalar

* <-|[App.events(occurredAtMin)](https://shopify.dev/docs/api/partner/2025-01/objects/App#field-App.fields.events.arguments.occurredAtMin)
* <-|[App.events(occurredAtMax)](https://shopify.dev/docs/api/partner/2025-01/objects/App#field-App.fields.events.arguments.occurredAtMax)
* <-|[Query​Root.transactions(createdAtMin)](https://shopify.dev/docs/api/partner/2025-01/objects/QueryRoot#field-QueryRoot.fields.transactions.arguments.createdAtMin)
* <-|[Query​Root.transactions(createdAtMax)](https://shopify.dev/docs/api/partner/2025-01/objects/QueryRoot#field-QueryRoot.fields.transactions.arguments.createdAtMax)
* <-|[transactions.createdAtMin](https://shopify.dev/docs/api/partner/2025-01/queries/transactions#arguments-createdAtMin)
* <-|[transactions.createdAtMax](https://shopify.dev/docs/api/partner/2025-01/queries/transactions#arguments-createdAtMax)