utils: Add new datetime_format module.

ievv_opensource/utils/datetime_format.py

@@ -0,0 +1,21 @@
+import arrow
+from django.conf import settings
+from django.template import defaultfilters
+
+
+def format_datetime_in_timezone(datetime_object, datetime_format='DATETIME_FORMAT', timezone=settings.TIME_ZONE):
+    """
+    Format a datetime object in a timezone.
+
+    Args:
+        datetime_object (datetime.datetime): Datetime object to format.
+        datetime_format (str): A Django datetime formatting string name, such as ``"DATETIME_FORMAT"``,
+            ``"SHORT_DATETIME_FORMAT``", ``"DATE_FORMAT"``, ...
+        timezone (str): Defaults to ``settings.TIME_ZONE``. The datetime is converted to
+            this timezone. So if you use UTC in the database, and want to present another
+            timezone, this will convert it correctly.
+
+    Returns:
+        str: The formatted datetime.
+    """
+    return defaultfilters.date(arrow.get(datetime_object).to(timezone).datetime, datetime_format)

not_for_deploy/docs/index.rst

@@ -79,6 +79,7 @@ Utilities
    utils.validate_redirect_url
    utils.testhelpers
    utils.validation_error_util
+   utils.datetime_format
 
 
 ************

not_for_deploy/docs/releasenotes/releasenotes-5.10.0.rst

@@ -0,0 +1,8 @@
+##################################
+ievv_opensource 5.10.0 releasenotes
+##################################
+
+************
+New features
+************
+- New ``utils.datetime_format`` module - see :doc:`/utils.datetime_format`.

not_for_deploy/docs/utils.datetime_format.rst

@@ -0,0 +1,6 @@
+##############################################################
+`utils.datetime_format` --- Utilities for formatting datetimes
+##############################################################
+
+.. currentmodule:: ievv_opensource.utils.datetime_format
+.. automodule:: ievv_opensource.utils.datetime_format

setup.py

@@ -24,6 +24,7 @@
         'termcolor',
         'psutil',
         'future',
+        'arrow',
     ],
     entry_points={
         'console_scripts': [