Our primary distribution channel is NuGet with three packages:
See the "Building and testing" section in the developer guide for instructions on building Noda Time from source.
Noda Time 3.0 (and onwards) supports the Target Framework Moniker of
This means it should work for any desktop framework application targeting .NET 4.7.2 or later, as well as .NET Core 2.0 and related frameworks. It does not support Windows 8 store apps, or Windows Phone (Silverlight or not) 8 apps. It does support UWP for (recent versions of) Windows 10. See the .NET Standard Versions documentation for more details.
We have not tested Noda Time 3.0 against Xamarin or Unity; recent versions of Xamarin support .NET Standard so should be fine; Unity targeting .NET 2.0 won't work, but the 2017-onwards support for Mono 4.8 may just work. (Please report any problems you have and we can try to look into them.)
Everything you need to use Noda Time is contained in the
NodaTime package. The
NodaTime.Testing package is designed
for testing code which uses Noda Time. See the testing guide for more information. It is expected
that production code will only refer to the
NodaTime.dll assembly, and that's all that's required at execution time.
This assembly includes the TZDB database as an embedded resource.
For Json.NET serialization, the NodaTime.Serialization.JsonNet package (containing a single assembly of the same name) is required, as well as an appropriate version of Json.NET itself. There is a NuGet dependency from NodaTime.Serialization.JsonNet to the Newtonsoft.Json package, so if you're using NuGet you just need to refer to NodaTime.Serialization.JsonNet and an appropriate version of Json.NET will be installed automatically. See the serialization guide for more information on using Noda Time with Json.NET.
Everything within the NodaTime assembly is in the NodaTime namespace or a "child" namespace. After adding a reference to
the main assembly (either directly via the file system or with NuGet) and including an appropriate
using directive, you should
be able to start using Noda Time immediately, with no further effort.