• Introduction
• Overview
• Why does Noda Time exist?
• Installation
• Core
• Core concepts
• Choosing (and converting) between types
• Core types quick reference
• Design philosophy and conventions
• Text
• Text handling
• Patterns for Duration values
• Patterns for Offset values
• Patterns for Instant values
• Patterns for LocalTime values
• Patterns for LocalDate values
• Patterns for LocalDateTime values
• Patterns for OffsetDateTime values
• Patterns for ZonedDateTime values
• Patterns for Period values
• Advanced
• Date and time arithmetic
• BCL conversions
• Serialization
• Threading
• Library
• Unit testing with Noda Time
• Updating the time zone database
• Mono support
• Limitations of Noda Time
• Current roadmap
• Version history

Mono support

Mono is an open source implementation of the Common Language Infrastructure which runs on various platforms, including Windows, Linux and OS X.

Noda Time runs on Mono, but with some limitations:

• Noda Time is not developed on Mono, so while releases will be tested against it (running all the unit tests), code which isn't part of a release may not work. Please raise an issue on the tracker page if you come across a breakage like this, and we'll fix it as soon as possible.
• TimeZoneInfo in Mono has some critical flaws in the latest stable Mono release at the time of this writing (2.10.8) - while BclDateTimeZone may do the right thing, it may disagree with the results of calling methods directly on the time zone (issue 97). TimeZoneInfo.Local has particular issues on the latest tested version of Mono. As a result, trying to use the system local time zone on Mono or convert from that to the TZDB equivalent is likely to cause issues.
  • On Windows, TimeZoneInfo.Local throws TimeZoneNotFoundException
  • On Unix it returns a TimeZoneInfo with an Id of "Local", which isn't terribly useful (although it may contain the correct rules)
  • On Android it returns a null reference
• Some cultures in Mono have standard date/time patterns including "z" for "offset from UTC". These will not display appropriately when used for text formatting in Noda Time, as the "z" is meaningless for local dates and times (issue 98).
• Some cultures in Mono have standard date/time patterns which use the abbreviated am/pm designator, but have am/pm designators which are the same when abbreviated. In these cases, parsing is ambiguous.

The prebuilt binary packages can be used on Mono directly. To build from source, See the "Building and testing" section in the developer guide.