# LocalDateTime

## `LocalDateTime` Class

The `LocalDateTime` class represents a date and time without a time zone. It combines a `LocalDate` and a `LocalTime` to represent a specific date and time of day.

```typescript
var localdateTime = LocalDateTime.of(2023, 10, 24, 15, 30); 
// LDTIME 2023-10-24T15:30:00 
```

### Static Methods

#### `now(): LocalDateTime`

* Returns the current date and time.

```java
var currentDateTime = LocalDateTime.now();
```

#### `parse(text: String): LocalDateTime`

* Parses the input text to create a `LocalDateTime` instance.

```java
var parsedDateTime = LocalDateTime.parse("2023-10-24T15:30:45");
```

#### `of(year: Integer, month: Integer, dayOfMonth: Integer, hour: Integer, minute: Integer)`

* Creates a `LocalDateTime` instance with the specified year, month, day, hour, and minute values.

```java
var customDateTime = LocalDateTime.of(2023, 10, 24, 15, 30);
```

***

### Getter Methods

#### `getYear(): Int`

* Gets the year field.
* Returns the year as an `int` value.
* Example Usage:

  ```java
  var year = customDateTime.getYear();
  ```

#### `getMonthValue()`

* Gets the month-of-year field from 1 to 12.
* Returns the month as an `int` from 1 to 12.
* Example Usage:

  ```java
  var month = customDateTime.getMonthValue();
  ```

#### `getDayOfMonth()`

* Gets the day-of-month field.
* Returns the day-of-month as an `int` from 1 to 31.
* Example Usage:

  ```java
  var dayOfMonth = customDateTime.getDayOfMonth();
  ```

#### `getDayOfYear()`

* Gets the day-of-year field.
* Returns the day-of-year as an `int` from 1 to 365 (or 366 in a leap year).
* Example Usage:

  ```java
  var dayOfYear = customDateTime.getDayOfYear();
  ```

***

### Date Manipulation Methods

#### `minusYears(yearsToSubtract: Long)`

* Returns a new `LocalDateTime` with the specified number of years subtracted.
* Example Usage:

  ```java
  var newDateTime = customDateTime.minusYears(1);
  ```

#### `minusMonths(monthsToSubtract: Long)`

* Returns a new `LocalDateTime` with the specified number of months subtracted.
* Example Usage:

  ```java
  var newDateTime = customDateTime.minusMonths(2);
  ```

#### `minusWeeks(weeksToSubtract: Long)`

* Returns a new `LocalDateTime` with the specified number of weeks subtracted.
* Example Usage:

  ```java
  var newDateTime = customDateTime.minusWeeks(3);
  ```

#### `minusDays(daysToSubtract: Long)`

* Returns a new `LocalDateTime` with the specified number of days subtracted.
* Example Usage:

  <pre class="language-java"><code class="lang-java"><strong>var newDateTime = customDateTime.minusDays(10);
  </strong></code></pre>

#### `plusDays(daysToAdd: Long)`

* Returns a new `LocalDateTime` with the specified number of days added.
* Example Usage:

  ```java
  var newDateTime = customDateTime.plusDays(5);
  ```

#### `daysUntil(endDateTime: LocalDateTime)`

* Calculates the number of days until the specified end date and time.
* Example Usage:

  ```java
  var daysUntil = customDateTime.daysUntil(endDateTime);
  ```

#### `monthsUntil(endDateTime: LocalDateTime)`

* Calculates the number of months until the specified end date and time.
* Example Usage:

  ```java
  var monthsUntil = customDateTime.monthsUntil(endDateTime);
  ```

***

### Comparison Methods

#### `isBefore(other: LocalDateTime)`

* Checks if the current date and time is before the specified date and time.
* Returns `true` if the current date and time is before `other`, `false` otherwise.
* Example Usage:

  ```java
  var isBefore = customDateTime.isBefore(parsedDateTime);
  ```

#### `isAfter(other: LocalDateTime)`

* Checks if the current date and time is after the specified date and time.
* Returns `true` if the current date and time is after `other`, `false` otherwise.
* Example Usage:

  ```java
  var isAfter = customDateTime.isAfter(parsedDateTime);
  ```

***

### Date-Time Separation Methods

#### `toLocalDate()`

* Gets the `LocalDate` part of this date-time.
* Returns a `LocalDate` with the same year, month, and day as this date-time.
* Example Usage:

  ```java
  var datePart = customDateTime.toLocalDate();
  ```

#### `toLocalTime()`

* Gets the `LocalTime` part of this date-time.
* Returns a `LocalTime` with the same hour, minute, second, and nanosecond as this date-time.
* Example Usage:

  ```java
  var timePart = customDateTime.toLocalTime();
  ```