--- 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-10 api_name: partner type: scalar api_type: graphql source_url: html: https://shopify.dev/docs/api/partner/latest/scalars/datetime md: https://shopify.dev/docs/api/partner/latest/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/latest/objects/AppOneTimeSale#field-AppOneTimeSale.fields.createdAt) * <-|[App​Sale​Adjustment.createdAt](https://shopify.dev/docs/api/partner/latest/objects/AppSaleAdjustment#field-AppSaleAdjustment.fields.createdAt) * <-|[App​Sale​Credit.createdAt](https://shopify.dev/docs/api/partner/latest/objects/AppSaleCredit#field-AppSaleCredit.fields.createdAt) * <-|[App​Subscription.billingOn](https://shopify.dev/docs/api/partner/latest/objects/AppSubscription#field-AppSubscription.fields.billingOn) * <-|[App​Subscription​Sale.createdAt](https://shopify.dev/docs/api/partner/latest/objects/AppSubscriptionSale#field-AppSubscriptionSale.fields.createdAt) * <-|[App​Usage​Sale.createdAt](https://shopify.dev/docs/api/partner/latest/objects/AppUsageSale#field-AppUsageSale.fields.createdAt) * <-|[Conversation.createdAt](https://shopify.dev/docs/api/partner/latest/objects/Conversation#field-Conversation.fields.createdAt) * <-|[Conversation.lastEventAt](https://shopify.dev/docs/api/partner/latest/objects/Conversation#field-Conversation.fields.lastEventAt) * <-|[Credit​Applied.occurredAt](https://shopify.dev/docs/api/partner/latest/objects/CreditApplied#field-CreditApplied.fields.occurredAt) * <-|[Credit​Failed.occurredAt](https://shopify.dev/docs/api/partner/latest/objects/CreditFailed#field-CreditFailed.fields.occurredAt) * <-|[Credit​Pending.occurredAt](https://shopify.dev/docs/api/partner/latest/objects/CreditPending#field-CreditPending.fields.occurredAt) * <-|[Job.createdAt](https://shopify.dev/docs/api/partner/latest/objects/Job#field-Job.fields.createdAt) * <-|[Job.lastEventAt](https://shopify.dev/docs/api/partner/latest/objects/Job#field-Job.fields.lastEventAt) * <-|[Legacy​Transaction.createdAt](https://shopify.dev/docs/api/partner/latest/objects/LegacyTransaction#field-LegacyTransaction.fields.createdAt) * <-|[Message.sentAt](https://shopify.dev/docs/api/partner/latest/objects/Message#field-Message.fields.sentAt) * <-|[One​Time​Charge​Accepted.occurredAt](https://shopify.dev/docs/api/partner/latest/objects/OneTimeChargeAccepted#field-OneTimeChargeAccepted.fields.occurredAt) * <-|[One​Time​Charge​Activated.occurredAt](https://shopify.dev/docs/api/partner/latest/objects/OneTimeChargeActivated#field-OneTimeChargeActivated.fields.occurredAt) * <-|[One​Time​Charge​Declined.occurredAt](https://shopify.dev/docs/api/partner/latest/objects/OneTimeChargeDeclined#field-OneTimeChargeDeclined.fields.occurredAt) * <-|[One​Time​Charge​Expired.occurredAt](https://shopify.dev/docs/api/partner/latest/objects/OneTimeChargeExpired#field-OneTimeChargeExpired.fields.occurredAt) * <-|[Referral​Adjustment.createdAt](https://shopify.dev/docs/api/partner/latest/objects/ReferralAdjustment#field-ReferralAdjustment.fields.createdAt) * <-|[Referral​Transaction.createdAt](https://shopify.dev/docs/api/partner/latest/objects/ReferralTransaction#field-ReferralTransaction.fields.createdAt) * <-|[Relationship​Deactivated.occurredAt](https://shopify.dev/docs/api/partner/latest/objects/RelationshipDeactivated#field-RelationshipDeactivated.fields.occurredAt) * <-|[Relationship​Installed.occurredAt](https://shopify.dev/docs/api/partner/latest/objects/RelationshipInstalled#field-RelationshipInstalled.fields.occurredAt) * <-|[Relationship​Reactivated.occurredAt](https://shopify.dev/docs/api/partner/latest/objects/RelationshipReactivated#field-RelationshipReactivated.fields.occurredAt) * <-|[Relationship​Uninstalled.occurredAt](https://shopify.dev/docs/api/partner/latest/objects/RelationshipUninstalled#field-RelationshipUninstalled.fields.occurredAt) * <-|[Service​Sale.createdAt](https://shopify.dev/docs/api/partner/latest/objects/ServiceSale#field-ServiceSale.fields.createdAt) * <-|[Service​Sale​Adjustment.createdAt](https://shopify.dev/docs/api/partner/latest/objects/ServiceSaleAdjustment#field-ServiceSaleAdjustment.fields.createdAt) * <-|[Subscription​Approaching​Capped​Amount.occurredAt](https://shopify.dev/docs/api/partner/latest/objects/SubscriptionApproachingCappedAmount#field-SubscriptionApproachingCappedAmount.fields.occurredAt) * <-|[Subscription​Capped​Amount​Updated.occurredAt](https://shopify.dev/docs/api/partner/latest/objects/SubscriptionCappedAmountUpdated#field-SubscriptionCappedAmountUpdated.fields.occurredAt) * <-|[Subscription​Charge​Accepted.occurredAt](https://shopify.dev/docs/api/partner/latest/objects/SubscriptionChargeAccepted#field-SubscriptionChargeAccepted.fields.occurredAt) ### Arguments with this scalar * <-|[App.events(occurredAtMin)](https://shopify.dev/docs/api/partner/latest/objects/App#field-App.fields.events.arguments.occurredAtMin) * <-|[App.events(occurredAtMax)](https://shopify.dev/docs/api/partner/latest/objects/App#field-App.fields.events.arguments.occurredAtMax) * <-|[Conversation.messages(sentAtMin)](https://shopify.dev/docs/api/partner/latest/objects/Conversation#field-Conversation.fields.messages.arguments.sentAtMin) * <-|[Conversation.messages(sentAtMax)](https://shopify.dev/docs/api/partner/latest/objects/Conversation#field-Conversation.fields.messages.arguments.sentAtMax) * <-|[Query​Root.conversations(createdAtMin)](https://shopify.dev/docs/api/partner/latest/objects/QueryRoot#field-QueryRoot.fields.conversations.arguments.createdAtMin) * <-|[Query​Root.conversations(createdAtMax)](https://shopify.dev/docs/api/partner/latest/objects/QueryRoot#field-QueryRoot.fields.conversations.arguments.createdAtMax) * <-|[Query​Root.conversations(lastEventAtMin)](https://shopify.dev/docs/api/partner/latest/objects/QueryRoot#field-QueryRoot.fields.conversations.arguments.lastEventAtMin) * <-|[Query​Root.conversations(lastEventAtMax)](https://shopify.dev/docs/api/partner/latest/objects/QueryRoot#field-QueryRoot.fields.conversations.arguments.lastEventAtMax) * <-|[Query​Root.jobs(createdAtMin)](https://shopify.dev/docs/api/partner/latest/objects/QueryRoot#field-QueryRoot.fields.jobs.arguments.createdAtMin) * <-|[Query​Root.jobs(createdAtMax)](https://shopify.dev/docs/api/partner/latest/objects/QueryRoot#field-QueryRoot.fields.jobs.arguments.createdAtMax) * <-|[Query​Root.jobs(lastEventAtMin)](https://shopify.dev/docs/api/partner/latest/objects/QueryRoot#field-QueryRoot.fields.jobs.arguments.lastEventAtMin) * <-|[Query​Root.jobs(lastEventAtMax)](https://shopify.dev/docs/api/partner/latest/objects/QueryRoot#field-QueryRoot.fields.jobs.arguments.lastEventAtMax) * <-|[Query​Root.transactions(createdAtMin)](https://shopify.dev/docs/api/partner/latest/objects/QueryRoot#field-QueryRoot.fields.transactions.arguments.createdAtMin) * <-|[Query​Root.transactions(createdAtMax)](https://shopify.dev/docs/api/partner/latest/objects/QueryRoot#field-QueryRoot.fields.transactions.arguments.createdAtMax) * <-|[conversations.createdAtMin](https://shopify.dev/docs/api/partner/latest/queries/conversations#arguments-createdAtMin) * <-|[conversations.createdAtMax](https://shopify.dev/docs/api/partner/latest/queries/conversations#arguments-createdAtMax) * <-|[conversations.lastEventAtMin](https://shopify.dev/docs/api/partner/latest/queries/conversations#arguments-lastEventAtMin) * <-|[conversations.lastEventAtMax](https://shopify.dev/docs/api/partner/latest/queries/conversations#arguments-lastEventAtMax) * <-|[jobs.createdAtMin](https://shopify.dev/docs/api/partner/latest/queries/jobs#arguments-createdAtMin) * <-|[jobs.createdAtMax](https://shopify.dev/docs/api/partner/latest/queries/jobs#arguments-createdAtMax) * <-|[jobs.lastEventAtMin](https://shopify.dev/docs/api/partner/latest/queries/jobs#arguments-lastEventAtMin) * <-|[jobs.lastEventAtMax](https://shopify.dev/docs/api/partner/latest/queries/jobs#arguments-lastEventAtMax) * <-|[transactions.createdAtMin](https://shopify.dev/docs/api/partner/latest/queries/transactions#arguments-createdAtMin) * <-|[transactions.createdAtMax](https://shopify.dev/docs/api/partner/latest/queries/transactions#arguments-createdAtMax)