Server/project/src/utils/TimeUtil.ts

import { formatInTimeZone } from "date-fns-tz";
import { injectable } from "tsyringe";

/**
 * Utility class to handle time related operations.
 */
@injectable()
export class TimeUtil
{
    public static readonly ONE_HOUR_AS_SECONDS = 3600; // Number of seconds in one hour.

    /**
     * Pads a number with a leading zero if it is less than 10.
     *
     * @param {number} number - The number to pad.
     * @returns {string} The padded number as a string.
     */
    protected pad(number: number): string
    {
        return String(number).padStart(2, "0");
    }

    /**
     * Formats the time part of a date as a UTC string.
     *
     * @param {Date} date - The date to format in UTC.
     * @returns {string} The formatted time as 'HH-MM-SS'.
     */
    public formatTime(date: Date): string
    {
        const hours = this.pad(date.getUTCHours());
        const minutes = this.pad(date.getUTCMinutes());
        const seconds = this.pad(date.getUTCSeconds());
        return `${hours}-${minutes}-${seconds}`;
    }

    /**
     * Formats the date part of a date as a UTC string.
     *
     * @param {Date} date - The date to format in UTC.
     * @returns {string} The formatted date as 'YYYY-MM-DD'.
     */
    public formatDate(date: Date): string
    {
        const day = this.pad(date.getUTCDate());
        const month = this.pad(date.getUTCMonth() + 1); // getUTCMonth returns 0-11
        const year = date.getUTCFullYear();
        return `${year}-${month}-${day}`;
    }

    /**
     * Gets the current date as a formatted UTC string.
     *
     * @returns {string} The current date as 'YYYY-MM-DD'.
     */
    public getDate(): string
    {
        return this.formatDate(new Date());
    }

    /**
     * Gets the current time as a formatted UTC string.
     *
     * @returns {string} The current time as 'HH-MM-SS'.
     */
    public getTime(): string
    {
        return this.formatTime(new Date());
    }

    /**
     * Gets the current timestamp in seconds in UTC.
     *
     * @returns {number} The current timestamp in seconds since the Unix epoch in UTC.
     */
    public getTimestamp(): number
    {
        return Math.floor(new Date().getTime() / 1000);
    }

    /**
     * Gets the current time in UTC in a format suitable for mail in EFT.
     *
     * @returns {string} The current time as 'HH:MM' in UTC.
     */
    public getTimeMailFormat(): string
    {
        return formatInTimeZone(new Date(), "UTC", "HH:mm");
    }

    /**
     * Gets the current date in UTC in a format suitable for emails in EFT.
     *
     * @returns {string} The current date as 'DD.MM.YYYY' in UTC.
     */
    public getDateMailFormat(): string
    {
        return formatInTimeZone(new Date(), "UTC", "dd.MM.yyyy");
    }

    /**
     * Converts a number of hours into seconds.
     *
     * @param {number} hours - The number of hours to convert.
     * @returns {number} The equivalent number of seconds.
     */
    public getHoursAsSeconds(hours: number): number
    {
        return hours * TimeUtil.ONE_HOUR_AS_SECONDS;
    }
}