Contents Menu Expand Light mode Dark mode Auto light/dark, in light mode Auto light/dark, in dark mode Skip to content
Whenever
Whenever

Background

  • The fundamentals of time
    • Exact time vs local time
    • Timezones
    • Ambiguity
    • Arithmetic
  • The pitfalls of datetime
    • One type for everything
    • Operators ignore DST
    • Inconsistent role of “naive”
    • Ambiguity passes silently
    • Equality edge cases
    • timezone isn’t enough
    • Implicit system time zone
    • datetime inherits from date
    • timedelta.seconds footgun
  • Why not pendulum?

Overview

  • Guide
    • Choosing the right type
    • Comparison and equality
    • Converting between types
    • Ambiguity in timezones
    • Arithmetic
    • Working with deltas
    • Rounding
    • Formatting and parsing
    • Standard library conversions
    • Partial types
    • The system timezone
    • Testing
    • Handling warnings
  • Examples
  • Design philosophy
  • FAQ

API Reference

  • ISO 8601
  • Pattern format
  • Main types
    • Instant
    • ZonedDateTime
    • OffsetDateTime
    • PlainDateTime
  • Partial types
    • Date
    • Time
    • YearMonth
    • MonthDay
  • Delta types
    • TimeDelta
    • ItemizedDelta
    • ItemizedDateDelta
  • Miscellaneous
    • Other types
    • Exceptions and warnings
    • Deprecated components

Development

  • Changelog
  • Contributing
  • Github repository
Back to top
View this page

Guide¶

This page gives quick overview of the key concepts to help you get started with whenever.

For background on date and time in general, see the concepts guide. For more details, see the API reference.

Contents¶

  • Choosing the right type
  • Comparison and equality
  • Converting between types
  • Ambiguity in timezones
  • Arithmetic
  • Working with deltas
  • Rounding
  • Formatting and parsing
  • Standard library conversions
  • Partial types
  • The system timezone
  • Testing
  • Handling warnings
Next
Choosing the right type
Previous
Why not pendulum?
Copyright ©
Made with Sphinx and @pradyunsg's Furo