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

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

2 

3# Copyright (c) 2026, Brandon Nielsen 

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

5 

6import datetime 

7 

8 

9class UTCOffset(datetime.tzinfo): 

10 def __init__(self, name=None, minutes=None): 

11 # We build an offset in this manner since the 

12 # tzinfo class must have an init 

13 # "method that can be called with no arguments" 

14 self._name = name 

15 

16 if minutes is not None: 

17 self._utcdelta = datetime.timedelta(minutes=minutes) 

18 else: 

19 self._utcdelta = None 

20 

21 def __repr__(self): 

22 if self._utcdelta >= datetime.timedelta(hours=0): 

23 return "+{0} UTC".format(self._utcdelta) 

24 

25 # From the docs: 

26 # String representations of timedelta objects are normalized 

27 # similarly to their internal representation. This leads to 

28 # somewhat unusual results for negative timedeltas. 

29 

30 # Clean this up for printing purposes 

31 # Negative deltas start at -1 day 

32 correcteddays = abs(self._utcdelta.days + 1) 

33 

34 # Negative deltas have a positive seconds 

35 deltaseconds = (24 * 60 * 60) - self._utcdelta.seconds 

36 

37 # (24 hours / day) * (60 minutes / hour) * (60 seconds / hour) 

38 days, remainder = divmod(deltaseconds, 24 * 60 * 60) 

39 

40 # (1 hour) * (60 minutes / hour) * (60 seconds / hour) 

41 hours, remainder = divmod(remainder, 1 * 60 * 60) 

42 

43 # (1 minute) * (60 seconds / minute) 

44 minutes, seconds = divmod(remainder, 1 * 60) 

45 

46 # Add any remaining days to the correcteddays count 

47 correcteddays += days 

48 

49 if correcteddays == 0: 

50 return "-{0}:{1:02}:{2:02} UTC".format(hours, minutes, seconds) 

51 if correcteddays == 1: 

52 return "-1 day, {0}:{1:02}:{2:02} UTC".format(hours, minutes, seconds) 

53 

54 return "-{0} days, {1}:{2:02}:{3:02} UTC".format( 

55 correcteddays, hours, minutes, seconds 

56 ) 

57 

58 def utcoffset(self, dt): 

59 return self._utcdelta 

60 

61 def tzname(self, dt): 

62 return self._name 

63 

64 def dst(self, dt): 

65 # ISO 8601 specifies offsets should be different if DST is required, 

66 # instead of allowing for a DST to be specified 

67 # https://docs.python.org/2/library/datetime.html#datetime.tzinfo.dst 

68 return datetime.timedelta(0)