Coverage for /pythoncovmergedfiles/medio/medio/usr/local/lib/python3.11/site-packages/aniso8601/timezone.py: 94%

1# -*- coding: utf-8 -*- 

2 

3# Copyright (c) 2026, Brandon Nielsen 

4# SPDX-License-Identifier: BSD-3-Clause 

5 

6from aniso8601.builders.python import PythonTimeBuilder 

7from aniso8601.compat import is_string 

8from aniso8601.exceptions import ISOFormatError 

9 

10 

11def parse_timezone(tzstr, builder=PythonTimeBuilder): 

12 # tzstr can be Z, ±hh:mm, ±hhmm, ±hh 

13 if is_string(tzstr) is False: 

14 raise ValueError("Time zone must be string.") 

15 

16 if len(tzstr) == 1 and tzstr[0] == "Z": 

17 return builder.build_timezone(negative=False, Z=True, name=tzstr) 

18 

19 if len(tzstr) == 6: 

20 # ±hh:mm 

21 hourstr = tzstr[1:3] 

22 minutestr = tzstr[4:6] 

23 

24 if tzstr[0] == "-" and hourstr == "00" and minutestr == "00": 

25 raise ISOFormatError("Negative ISO 8601 time offset must not be 0.") 

26 elif len(tzstr) == 5: 

27 # ±hhmm 

28 hourstr = tzstr[1:3] 

29 minutestr = tzstr[3:5] 

30 

31 if tzstr[0] == "-" and hourstr == "00" and minutestr == "00": 

32 raise ISOFormatError("Negative ISO 8601 time offset must not be 0.") 

33 elif len(tzstr) == 3: 

34 # ±hh 

35 hourstr = tzstr[1:3] 

36 minutestr = None 

37 

38 if tzstr[0] == "-" and hourstr == "00": 

39 raise ISOFormatError("Negative ISO 8601 time offset must not be 0.") 

40 else: 

41 raise ISOFormatError('"{0}" is not a valid ISO 8601 time offset.'.format(tzstr)) 

42 

43 for componentstr in [hourstr, minutestr]: 

44 if componentstr is not None: 

45 if componentstr.isdigit() is False: 

46 raise ISOFormatError( 

47 '"{0}" is not a valid ISO 8601 time offset.'.format(tzstr) 

48 ) 

49 

50 if tzstr[0] == "+": 

51 return builder.build_timezone( 

52 negative=False, hh=hourstr, mm=minutestr, name=tzstr 

53 ) 

54 

55 if tzstr[0] == "-": 

56 return builder.build_timezone( 

57 negative=True, hh=hourstr, mm=minutestr, name=tzstr 

58 ) 

59 

60 raise ISOFormatError('"{0}" is not a valid ISO 8601 time offset.'.format(tzstr))