StripeKit - Timezones

Stripe stores every timestamp as a Unix epoch, which is UTC by definition. StripeKit always does the conversion in two explicit steps, never one:

Normalize to UTC. The raw Unix timestamp is converted into an ISO-8601 UTC string. This is always available as the ...Utc field, for example currentPeriodEndUtc, issuedAtUtc, paidAtUtc.

Convert to your configured timezone. If you set a timezone on init, anything other than "UTC", the default, that UTC value is converted once more into your chosen timezone and exposed as the matching ...Local field, for example currentPeriodEndLocal.

If you don't set a timezone, both fields are UTC, and no double conversion happens.

Helpers

The timezone conversion logic is also exported directly, in case you need it outside the normalized records:

Timezones

Helpers#

Helpers