Time Utilities

Time utilities in Python.

TimeUtil class

Methods

Examples:

• TimeUtil.date_ms_to_date_str

  Code

  from nrt_time_utils.time_utils import TimeUtil
  
  # Convert a date in milliseconds to a date string
  date_str = TimeUtil.date_ms_to_date_str(1617223200000)
  
  print(date_str)
  

  Output

  2021-03-31 00:00:00.000
  

• TimeUtil.date_ms_to_date_time

  Code

  from nrt_time_utils.time_utils import TimeUtil
  
  # Convert a date in milliseconds to a date time object
  dt = TimeUtil.date_ms_to_date_time(1609459200000, 'UTC')
  
  print(dt)
  
  dt = TimeUtil.date_ms_to_date_time()
  

  Output

  2021-01-01 00:00:00+00:00
  

• TimeUtil.date_str_to_date_ms

  Code

  from nrt_time_utils.time_utils import TimeUtil, YMD_HMSF_Z_DATE_FORMAT
  
  # Convert a date string to a date in milliseconds
  date_ms = \
      TimeUtil.date_str_to_date_ms(
          '2021-01-01 02:02:00.000000 UTC', YMD_HMSF_Z_DATE_FORMAT)
  
  print(date_ms)
  

  Output

  1609466520000
  

• TimeUtil.date_str_to_date_time

  Code

  from nrt_time_utils.time_utils import TimeUtil
  
  # Convert a date string to a date time object
  dt = TimeUtil.date_str_to_date_time('2021-03-31 00:00:00.000')
  
  print(dt)
  

  Output

  2021-03-31 00:00:00
  

• TimeUtil.date_time_to_date_ms

  Code

  from nrt_time_utils.time_utils import TimeUtil
  from datetime import datetime
  
  # Convert a date time object to a date in milliseconds
  date_ms = TimeUtil.date_time_to_date_ms(datetime(2021, 3, 31, 0, 0, 0))
  
  print(date_ms)
  

  Output

  1617223200000
  

• TimeUtil.get_current_date_ms

  Code

  from nrt_time_utils.time_utils import TimeUtil
  
  # Get the current date in milliseconds
  current_date_ms = TimeUtil.get_current_date_ms()
  
  print(current_date_ms)
  

  Output

  1617223200000
  

• TimeUtil.get_day_end_date_ms

  Code

  from nrt_time_utils.time_utils import TimeUtil
  
  # Get the end of the day in milliseconds
  day_end_date_ms = TimeUtil.get_day_end_date_ms(1612137600001, 'UTC')
  
  print(day_end_date_ms)
  

  Output

  1612223999999
  

• TimeUtil.get_day_start_date_ms

  Code

  from nrt_time_utils.time_utils import TimeUtil
  
  # Get the start of the day in milliseconds
  day_start_date_ms = TimeUtil.get_day_start_date_ms(1612137600001, 'UTC')
  
  print(day_start_date_ms)
  

  Output

  1612137600000
  

• TimeUtil.get_timezone

  Code

  from nrt_time_utils.time_utils import TimeUtil
  
  # Get the timezone
  timezone = TimeUtil.get_timezone('Asia/Jerusalem')
  
  print(timezone)
  

  Output

  Asia/Jerusalem
  

• TimeUtil.get_timezone_offset_hours

  Code

  from nrt_time_utils.time_utils import TimeUtil
  
  # Get the timezone offset in hours
  timezone_offset = TimeUtil.get_timezone_offset_hours('PDT')
  
  print(timezone_offset)
  

  Output

  -7
  

• TimeUtil.is_leap_year

  Code

  from nrt_time_utils.time_utils import TimeUtil
  
  # Check if a year is a leap year
  is_leap_year = TimeUtil.is_leap_year(2020)
  
  print(is_leap_year)
  

  Output

  True
  

• TimeUtil.is_timeout_ms

  Code

  from nrt_time_utils.time_utils import TimeUtil
  from time import sleep
  
  current_date_ms = TimeUtil.get_current_date_ms()
  is_timeout = TimeUtil.is_timeout_ms(current_date_ms, 1000)
  print(is_timeout)
  sleep(2)
  is_timeout = TimeUtil.is_timeout_ms(current_date_ms, 1000)
  print(is_timeout)
  

  Output

  False
  True
  

• TimeUtil.is_date_in_format

  Code

  from nrt_time_utils.time_utils import TimeUtil, YMD_HMSF_DATE_FORMAT
  
  # Check if a date string is in a specific format
  is_date_in_format = \
      TimeUtil.is_date_in_format('2021-03-31 00:00:00.000', YMD_HMSF_DATE_FORMAT)
  
  print(is_date_in_format)
  

  Output

  True
  

Timer methods

Record the time it takes to execute a method or a block of code.

Methods

Timer class

Examples:

• method_timer

  Code

  from from nrt_time_utils.timer import method_timer
  
  def my_method(a, b):
      return a + b
  
  timer = method_timer(my_method, 1, 2)
  
  print(timer.execution_time_ms)
  

  Output

  1
  

• timer decorator

  Code

  from time import sleep  
  from from nrt_time_utils.timer import timer, get_timer_results
  
  @timer()
  def my_method(a, b):
      sleep(1)
      return a + b
  
  my_method(1, 2)
  
  timer_results = get_timer_results()
  
  for timer_result_list in timer_results.values():
      print(timer_result_list[0].execution_time_ms)
  

  Output

  1001
  

• with Timer() as t:

  Code

  from time import sleep
  from from nrt_time_utils.timer import Timer
  
  with Timer() as t:
      sleep(1)
  
  print(t.execution_time_ms)
  

  Output

  1000