// Copyright 2011 The Noda Time Authors. All rights reserved.

// Use of this source code is governed by the Apache License 2.0,

// as found in the LICENSE.txt file.

​

using NodaTime.Annotations;

using NodaTime.Calendars;

using NodaTime.Text;

using NodaTime.Text.Patterns;

using NodaTime.TimeZones;

using NodaTime.Utility;

using System;

using System.Collections.Concurrent;

using System.Collections.Generic;

using System.Collections.ObjectModel;

using System.Globalization;

​

namespace NodaTime.Globalization

{

    /// <summary>

    /// A <see cref="IFormatProvider"/> for Noda Time types, usually initialised from a <see cref="System.Globalization.CultureInfo"/>.

    /// This provides a single place defining how NodaTime values are formatted and displayed, depending on the culture.

    /// </summary>

    /// <remarks>

    /// Currently this is "shallow-immutable" - although none of these properties can be changed, the

    /// CultureInfo itself may be mutable. If the CultureInfo is mutated after initialization, results are not

    /// guaranteed: some aspects of the CultureInfo may be extracted at initialization time, others may be

    /// extracted on first demand but cached, and others may be extracted on-demand each time.

    /// </remarks>

    /// <threadsafety>Instances which use read-only CultureInfo instances are immutable,