Date arithmetic

time_add_days

Add N days to a Unix timestamp.

Arguments

  • $1 (int): Unix timestamp
  • $2 (int): Number of days to add (default: 1)

Exit codes

  • 0: Success; 1 date error; 2 Missing arguments

Output on stdout

  • New Unix timestamp

time_add_weeks

Add N weeks to a Unix timestamp.

Arguments

  • $1 (int): Unix timestamp
  • $2 (int): Number of weeks to add (default: 1)

Exit codes

  • 0: Success; 1 date error; 2 Missing arguments

Output on stdout

  • New Unix timestamp

time_add_months

Add N months to a Unix timestamp.

Arguments

  • $1 (int): Unix timestamp
  • $2 (int): Number of months to add (default: 1)

Exit codes

  • 0: Success; 1 date error; 2 Missing arguments

Output on stdout

  • New Unix timestamp

time_add_years

Add N years to a Unix timestamp.

Arguments

  • $1 (int): Unix timestamp
  • $2 (int): Number of years to add (default: 1)

Exit codes

  • 0: Success; 1 date error; 2 Missing arguments

Output on stdout

  • New Unix timestamp

time_add_hours

Add N hours to a Unix timestamp.

Arguments

  • $1 (int): Unix timestamp
  • $2 (int): Number of hours to add (default: 1)

Exit codes

  • 0: Success; 1 date error; 2 Missing arguments

Output on stdout

  • New Unix timestamp

time_add_minutes

Add N minutes to a Unix timestamp.

Arguments

  • $1 (int): Unix timestamp
  • $2 (int): Number of minutes to add (default: 1)

Exit codes

  • 0: Success; 1 date error; 2 Missing arguments

Output on stdout

  • New Unix timestamp

time_add_seconds

Add N seconds to a Unix timestamp.

Arguments

  • $1 (int): Unix timestamp
  • $2 (int): Number of seconds to add (default: 1)

Exit codes

  • 0: Success; 1 date error; 2 Missing arguments

Output on stdout

  • New Unix timestamp

time_sub_days

Subtract N days from a Unix timestamp.

Arguments

  • $1 (int): Unix timestamp
  • $2 (int): Number of days to subtract (default: 1)

Exit codes

  • 0: Success; 1 date error; 2 Missing arguments

Output on stdout

  • New Unix timestamp

time_sub_weeks

Subtract N weeks from a Unix timestamp.

Arguments

  • $1 (int): Unix timestamp
  • $2 (int): Number of weeks to subtract (default: 1)

Exit codes

  • 0: Success; 1 date error; 2 Missing arguments

Output on stdout

  • New Unix timestamp

time_sub_months

Subtract N months from a Unix timestamp.

Arguments

  • $1 (int): Unix timestamp
  • $2 (int): Number of months to subtract (default: 1)

Exit codes

  • 0: Success; 1 date error; 2 Missing arguments

Output on stdout

  • New Unix timestamp

time_sub_years

Subtract N years from a Unix timestamp.

Arguments

  • $1 (int): Unix timestamp
  • $2 (int): Number of years to subtract (default: 1)

Exit codes

  • 0: Success; 1 date error; 2 Missing arguments

Output on stdout

  • New Unix timestamp

time_sub_hours

Subtract N hours from a Unix timestamp.

Arguments

  • $1 (int): Unix timestamp
  • $2 (int): Number of hours to subtract (default: 1)

Exit codes

  • 0: Success; 1 date error; 2 Missing arguments

Output on stdout

  • New Unix timestamp

time_sub_minutes

Subtract N minutes from a Unix timestamp.

Arguments

  • $1 (int): Unix timestamp
  • $2 (int): Number of minutes to subtract (default: 1)

Exit codes

  • 0: Success; 1 date error; 2 Missing arguments

Output on stdout

  • New Unix timestamp

time_sub_seconds

Subtract N seconds from a Unix timestamp.

Arguments

  • $1 (int): Unix timestamp
  • $2 (int): Number of seconds to subtract (default: 1)

Exit codes

  • 0: Success; 1 date error; 2 Missing arguments

Output on stdout

  • New Unix timestamp

time_format

Format a Unix timestamp as a human-readable string.

Arguments

  • $1 (int): Unix timestamp
  • $2 (string): strftime format string (default: "%F %T")

Exit codes

  • 0: Success; 1 date error; 2 Missing arguments

Output on stdout

  • Formatted date string