19631515375

Committed 24 Nov 2025 10:44AM UTC coverage: 66.034% (+31.2%) from 34.821%

Build # 19631515375

Build Type

push

github

Committed by Bernhard Haas

Commit Message

Merge branch 'main' of github.com:GFZ/EL_PASO

Run Details

1705 of 2582 relevant lines covered (66.03%)

1.32 hits per line

Source File
Press 'n' to go to next uncovered line, 'b' for previous

60.0

/el_paso/processing/convert_string_to_datetime.py

# SPDX-FileCopyrightText: 2025 GFZ Helmholtz Centre for Geosciences
# SPDX-FileContributor: Bernhard Haas
#
# SPDX-License-Identifier: Apache-2.0

from datetime import datetime, timezone

import numpy as np
from dateutil import parser
from numpy.typing import NDArray

from el_paso import Variable


def convert_string_to_datetime(time_var: Variable, time_format: str | None = None) -> NDArray[np.generic]:
    """Converts a Variable's string-based time data to UTC datetime objects.

    This function transforms an array of time strings into Python datetime objects,
    automatically setting the timezone to UTC. If time_format is provided, it uses
    datetime.strptime for explicit parsing; otherwise, it uses a flexible parser
    (like dateutil.parser.parse) to infer the format.

    Args:
        time_var (Variable): The variable containing string-based time data to be
            converted. Its data is accessed via time_var.get_data().
        time_format (str | None): The explicit format string (e.g., "%Y-%m-%d %H:%M:%S")
            used to parse the time data. If None (default), the function uses a
            flexible parser to infer the correct format.

    Returns:
        NDArray[np.generic]: A NumPy array of Python datetime objects that are all
            localized to the UTC timezone.
    """
    time_var.metadata.add_processing_note("Converting string-time to datetime")

    if time_format is None:
        return np.asarray([parser.parse(t).replace(tzinfo=timezone.utc) for t in time_var.get_data()])

    return np.asarray([datetime.strptime(t, time_format).replace(tzinfo=timezone.utc) for t in time_var.get_data()])

1	# SPDX-FileCopyrightText: 2025 GFZ Helmholtz Centre for Geosciences
2	# SPDX-FileContributor: Bernhard Haas
3	#
4	# SPDX-License-Identifier: Apache-2.0
5
6	from datetime import datetime, timezone	2✔
7
8	import numpy as np	2✔
9	from dateutil import parser	2✔
10	from numpy.typing import NDArray	2✔
11
12	from el_paso import Variable	2✔
13
14
15	def convert_string_to_datetime(time_var: Variable, time_format: str \| None = None) -> NDArray[np.generic]:	2✔
16	"""Converts a Variable's string-based time data to UTC datetime objects.
17
18	This function transforms an array of time strings into Python datetime objects,
19	automatically setting the timezone to UTC. If time_format is provided, it uses
20	datetime.strptime for explicit parsing; otherwise, it uses a flexible parser
21	(like dateutil.parser.parse) to infer the format.
22
23	Args:
24	time_var (Variable): The variable containing string-based time data to be
25	converted. Its data is accessed via time_var.get_data().
26	time_format (str \| None): The explicit format string (e.g., "%Y-%m-%d %H:%M:%S")
27	used to parse the time data. If None (default), the function uses a
28	flexible parser to infer the correct format.
29
30	Returns:
31	NDArray[np.generic]: A NumPy array of Python datetime objects that are all
32	localized to the UTC timezone.
33	"""
34	time_var.metadata.add_processing_note("Converting string-time to datetime")	×
35
36	if time_format is None:	×
37	return np.asarray([parser.parse(t).replace(tzinfo=timezone.utc) for t in time_var.get_data()])	×
38
39	return np.asarray([datetime.strptime(t, time_format).replace(tzinfo=timezone.utc) for t in time_var.get_data()])	×

GFZ / EL_PASO / 19631515375

Source File Press 'n' to go to next uncovered line, 'b' for previous

Source File
Press 'n' to go to next uncovered line, 'b' for previous