Guide

Everything you need to use whenever day to day, roughly in the order you’ll run into it. Start with choosing a type—the rest follows from that decision.

For background on dates and times in general, see the fundamentals. For the details of a specific class or method, see the API reference.

The essentials

• Choosing the right type
• Partial types
• Comparison and equality
• Converting between types
• Ambiguity in timezones

Calculating with dates and times

• Arithmetic
• Working with deltas
• Rounding

Talking to the outside world

• Formatting and parsing
• Standard library conversions
• The system timezone

Keeping it reliable

• Testing
• Handling warnings