Module datetime

This module contains date translations and helper functions for the KOReader frontend.

Functions

secondsToClock (seconds, withoutSeconds) Converts seconds to a clock string.
secondsToHClock (seconds, withoutSeconds, hmsFormat, withDays, compact) Converts seconds to a period of time string.
secondsToClockDuration (Either, withoutSeconds, withDays, compact) Converts seconds to a clock type (classic or modern), based on the given format preference "Classic" format calls secondsToClock, "Modern" and "Letters" formats call secondsToHClock
secondsToHour (seconds, twelve_hour_clock) Converts timestamp to an hour string
secondsToDate (seconds) Converts timestamp to a date string
secondsToDateTime (seconds, twelve_hour_clock) Converts timestamp to a date+time string
stringToSeconds (YYYY) Converts a date+time string to seconds


Functions

secondsToClock (seconds, withoutSeconds)
Converts seconds to a clock string.

Source: https://gist.github.com/jesseadams/791673

Parameters:

  • seconds integer number of seconds
  • withoutSeconds boolean if true 00:00, if false 00:00:00

Returns:

    string clock string in the form of 00:00 or 00:00:00
secondsToHClock (seconds, withoutSeconds, hmsFormat, withDays, compact)
Converts seconds to a period of time string.

Parameters:

  • seconds integer number of seconds
  • withoutSeconds boolean if true 1h30', if false 1h30'10"
  • hmsFormat boolean , if true format 1h 30m 10s
  • withDays boolean , if true format 1d12h30'10" or 1d 12h 30m 10s
  • compact boolean , if set removes all leading zeros (incl. units if necessary) and turns thinspaces into hairspaces (if present)

Returns:

    string clock string in the form of 1h30'10" or 1h 30m 10s
secondsToClockDuration (Either, withoutSeconds, withDays, compact)
Converts seconds to a clock type (classic or modern), based on the given format preference "Classic" format calls secondsToClock, "Modern" and "Letters" formats call secondsToHClock

Parameters:

  • Either string "modern" for 1h30'10", "letters" for 1h 30m 10s, or "classic" for 1:30:10
  • withoutSeconds boolean if true 1h30' or 1h 30m, if false 1h30'10" or 1h 30m 10s
  • withDays boolean , if hours>=24 include days in clock string 1d12h10'10" or 1d 12h 10m 10s
  • compact boolean , if set removes all leading zeros (incl. units if necessary) and turns thinspaces into hairspaces (if present)

Returns:

    string clock string in the specific format of 1h30', 1h30'10" resp. 1h 30m, 1h 30m 10s
secondsToHour (seconds, twelve_hour_clock)
Converts timestamp to an hour string

Parameters:

  • seconds integer number of seconds
  • twelve_hour_clock boolean

Returns:

    string hour string
secondsToDate (seconds)
Converts timestamp to a date string

Parameters:

  • seconds integer number of seconds

Returns:

    string date string
secondsToDateTime (seconds, twelve_hour_clock)
Converts timestamp to a date+time string

Parameters:

  • seconds integer number of seconds
  • twelve_hour_clock boolean

Returns:

    string date+time
stringToSeconds (YYYY)
Converts a date+time string to seconds

Parameters:

  • YYYY string -MM-DD HH:MM:SS", time may be absent

Returns:

    seconds
generated by LDoc 1.5.0 Last updated 2024-10-13 15:13:20