FTODate

The FTODate class provides comprehensive date and time manipulation functionality, with support for different time zones and time units.

Initialization

createFTODate: (
  value: string | number | Date,
  unit?: TimeUnit,
  timeZoneMode?: TimeZoneMode
) => FTODate;

The `timeZoneMode` parameter allows you to specify how the time should be interpreted:

- `TimeZoneMode.PROJECT`: Returns time in the project's timezone (default)
- `TimeZoneMode.UTC`: Returns time in UTC


## Methods

| Method                                              | Description                                              | Return Value                           |
| --------------------------------------------------- | -------------------------------------------------------- | -------------------------------------- |
| valueOf(timeUnit = TimeUnit.MILLISECONDS)           | Gets the timestamp value in specified time unit          | `number` - Timestamp in specified unit |
| toMilliseconds(timeZoneMode = TimeZoneMode.PROJECT) | Converts the date to milliseconds in specified timezone  | `number` - Milliseconds since epoch    |
| toSeconds(timeZoneMode = TimeZoneMode.PROJECT)      | Converts the date to seconds in specified timezone       | `number` - Seconds since epoch         |
| toString(timeZoneMode = TimeZoneMode.PROJECT)       | Converts the date to ISO string in specified timezone    | `string` - ISO formatted date string   |
| toJSDate(timeZoneMode = TimeZoneMode.PROJECT)       | Converts to JavaScript Date object in specified timezone | `Date` - JavaScript Date object        |
| dayOfMonth(timeZoneMode = TimeZoneMode.PROJECT)     | Gets the day of month (1-31)                             | `number` - Day of month                |
| monthOf(timeZoneMode = TimeZoneMode.PROJECT)        | Gets the month (1-12)                                    | `number` - Month number                |
| weekOf(timeZoneMode = TimeZoneMode.PROJECT)         | Gets the week number of the year                         | `number` - Week number                 |
| yearOf(timeZoneMode = TimeZoneMode.PROJECT)         | Gets the year                                            | `number` - Full year                   |
| dayOfYear(timeZoneMode = TimeZoneMode.PROJECT)      | Gets the day of year (1-366)                             | `number` - Day of year                 |
| dayOfWeek(timeZoneMode = TimeZoneMode.PROJECT)      | Gets the day of week (0-6, 0=Sunday)                     | `number` - Day of week                 |
| hour(timeZoneMode = TimeZoneMode.PROJECT)           | Gets the hour (0-23)                                     | `number` - Hour                        |
| minute(timeZoneMode = TimeZoneMode.PROJECT)         | Gets the minute (0-59)                                   | `number` - Minute                      |
| second(timeZoneMode = TimeZoneMode.PROJECT)         | Gets the second (0-59)                                   | `number` - Second                      |

## Example Usage

```typescript
// Create FTODate instance
const date = this.api.createFTODate(1707739200); // 2024.02.12 12:00:00 UTC

// Get components in project timezone
console.log(`Year: ${date.yearOf()}`);
console.log(`Month: ${date.monthOf()}`);
console.log(`Day: ${date.dayOfMonth()}`);
console.log(`Hour: ${date.hour()}`);
console.log(`Minute: ${date.minute()}`);
console.log(`Second: ${date.second()}`);

// Get components in UTC
console.log(`UTC Year: ${date.yearOf(TimeZoneMode.UTC)}`);
console.log(`UTC Month: ${date.monthOf(TimeZoneMode.UTC)}`);

// Convert to different formats
console.log(`Milliseconds: ${date.toMilliseconds()}`);
console.log(`Seconds: ${date.toSeconds()}`);
console.log(`ISO String: ${date.toString()}`);
console.log(`JS Date: ${date.toJSDate()}`);

// Get calendar information
console.log(`Day of Week: ${date.dayOfWeek()}`); // 0=Sunday
console.log(`Day of Year: ${date.dayOfYear()}`);
console.log(`Week of Year: ${date.weekOf()}`);