summaryrefslogtreecommitdiffstats
path: root/intl/locale/AppDateTimeFormat.h
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-07 19:33:14 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2024-04-07 19:33:14 +0000
commit36d22d82aa202bb199967e9512281e9a53db42c9 (patch)
tree105e8c98ddea1c1e4784a60a5a6410fa416be2de /intl/locale/AppDateTimeFormat.h
parentInitial commit. (diff)
downloadfirefox-esr-36d22d82aa202bb199967e9512281e9a53db42c9.tar.xz
firefox-esr-36d22d82aa202bb199967e9512281e9a53db42c9.zip
Adding upstream version 115.7.0esr.upstream/115.7.0esr
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'intl/locale/AppDateTimeFormat.h')
-rw-r--r--intl/locale/AppDateTimeFormat.h89
1 files changed, 89 insertions, 0 deletions
diff --git a/intl/locale/AppDateTimeFormat.h b/intl/locale/AppDateTimeFormat.h
new file mode 100644
index 0000000000..cdc8a499bb
--- /dev/null
+++ b/intl/locale/AppDateTimeFormat.h
@@ -0,0 +1,89 @@
+/* -*- Mode: C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*-
+ *
+ * This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
+
+#ifndef mozilla_intl_AppDateTimeFormat_h
+#define mozilla_intl_AppDateTimeFormat_h
+
+#include <time.h>
+#include "gtest/MozGtestFriend.h"
+#include "nsTHashMap.h"
+#include "nsString.h"
+#include "prtime.h"
+#include "mozilla/intl/DateTimeFormat.h"
+
+namespace mozilla::intl {
+
+/**
+ * Get a DateTimeFormat for use in Gecko. This specialized DateTimeFormat
+ * respects the user's OS and app preferences, and provides caching of the
+ * underlying mozilla::intl resources.
+ *
+ * This class is not thread-safe as it lazily initializes a cache without
+ * any type of multi-threaded protections.
+ */
+class AppDateTimeFormat {
+ public:
+ /**
+ * Format a DateTime using the applied app and OS-level preferences, with a
+ * style bag and the PRTime.
+ */
+ static nsresult Format(const DateTimeFormat::StyleBag& aStyle,
+ const PRTime aPrTime, nsAString& aStringOut);
+
+ /**
+ * Format a DateTime using the applied app and OS-level preferences, with a
+ * style bag and the PRExplodedTime.
+ */
+ static nsresult Format(const DateTimeFormat::StyleBag& aStyle,
+ const PRExplodedTime* aExplodedTime,
+ nsAString& aStringOut);
+
+ /**
+ * Format a DateTime using the applied app and OS-level preferences, with a
+ * components bag and the PRExplodedTime.
+ */
+ static nsresult Format(const DateTimeFormat::ComponentsBag& aComponents,
+ const PRExplodedTime* aExplodedTime,
+ nsAString& aStringOut);
+
+ /**
+ * If the app locale changes, the cached locale needs to be reset.
+ */
+ static void ClearLocaleCache();
+
+ static void Shutdown();
+
+ private:
+ AppDateTimeFormat() = delete;
+
+ static nsresult Initialize();
+ static void DeleteCache();
+ static const size_t kMaxCachedFormats = 15;
+
+ FRIEND_TEST(AppDateTimeFormat, FormatPRExplodedTime);
+ FRIEND_TEST(AppDateTimeFormat, DateFormatSelectors);
+ FRIEND_TEST(AppDateTimeFormat, FormatPRExplodedTimeForeign);
+ FRIEND_TEST(AppDateTimeFormat, DateFormatSelectorsForeign);
+
+ /**
+ * Format a DateTime using the applied app and OS-level preferences, with a
+ * components bag and the PRExplodedTime.
+ */
+ static nsresult Format(const DateTimeFormat::StyleBag& aStyle,
+ const double aUnixEpoch,
+ const PRTimeParameters* aTimeParameters,
+ nsAString& aStringOut);
+
+ static void BuildTimeZoneString(const PRTimeParameters& aTimeParameters,
+ nsAString& aStringOut);
+
+ static nsCString* sLocale;
+ static nsTHashMap<nsCStringHashKey, UniquePtr<DateTimeFormat>>* sFormatCache;
+};
+
+} // namespace mozilla::intl
+
+#endif /* mozilla_intl_AppDateTimeFormat_h */