Mastering Java's LocalDate ofEpochDay Method

Introduction

Java LocalDate ofEpochDay() method is used to get a LocalDate from the epoch-day count. The epoch-day is a simple incrementing count of days from January 1st, 1970.

Skills Graph

%%%%{init: {'theme':'neutral'}}%%%% flowchart RL java(("`Java`")) -.-> java/ProgrammingTechniquesGroup(["`Programming Techniques`"]) java(("`Java`")) -.-> java/ObjectOrientedandAdvancedConceptsGroup(["`Object-Oriented and Advanced Concepts`"]) java(("`Java`")) -.-> java/BasicSyntaxGroup(["`Basic Syntax`"]) java(("`Java`")) -.-> java/DataStructuresGroup(["`Data Structures`"]) java(("`Java`")) -.-> java/SystemandDataProcessingGroup(["`System and Data Processing`"]) java/ProgrammingTechniquesGroup -.-> java/scope("`Scope`") java/ObjectOrientedandAdvancedConceptsGroup -.-> java/classes_objects("`Classes/Objects`") java/ObjectOrientedandAdvancedConceptsGroup -.-> java/class_methods("`Class Methods`") java/ObjectOrientedandAdvancedConceptsGroup -.-> java/date("`Date`") java/ObjectOrientedandAdvancedConceptsGroup -.-> java/modifiers("`Modifiers`") java/ObjectOrientedandAdvancedConceptsGroup -.-> java/oop("`OOP`") java/ObjectOrientedandAdvancedConceptsGroup -.-> java/packages_api("`Packages / API`") java/BasicSyntaxGroup -.-> java/identifier("`Identifier`") java/DataStructuresGroup -.-> java/arrays("`Arrays`") java/BasicSyntaxGroup -.-> java/comments("`Comments`") java/BasicSyntaxGroup -.-> java/data_types("`Data Types`") java/BasicSyntaxGroup -.-> java/operators("`Operators`") java/BasicSyntaxGroup -.-> java/output("`Output`") java/SystemandDataProcessingGroup -.-> java/system_methods("`System Methods`") subgraph Lab Skills java/scope -.-> lab-117832{{"`Java LocalDate ofEpochDay Method`"}} java/classes_objects -.-> lab-117832{{"`Java LocalDate ofEpochDay Method`"}} java/class_methods -.-> lab-117832{{"`Java LocalDate ofEpochDay Method`"}} java/date -.-> lab-117832{{"`Java LocalDate ofEpochDay Method`"}} java/modifiers -.-> lab-117832{{"`Java LocalDate ofEpochDay Method`"}} java/oop -.-> lab-117832{{"`Java LocalDate ofEpochDay Method`"}} java/packages_api -.-> lab-117832{{"`Java LocalDate ofEpochDay Method`"}} java/identifier -.-> lab-117832{{"`Java LocalDate ofEpochDay Method`"}} java/arrays -.-> lab-117832{{"`Java LocalDate ofEpochDay Method`"}} java/comments -.-> lab-117832{{"`Java LocalDate ofEpochDay Method`"}} java/data_types -.-> lab-117832{{"`Java LocalDate ofEpochDay Method`"}} java/operators -.-> lab-117832{{"`Java LocalDate ofEpochDay Method`"}} java/output -.-> lab-117832{{"`Java LocalDate ofEpochDay Method`"}} java/system_methods -.-> lab-117832{{"`Java LocalDate ofEpochDay Method`"}} end

Importing the LocalDate class

Import the java.time.LocalDate class to your Java program.

import java.time.LocalDate;

Using the `ofEpochDay()` method

To use the ofEpochDay() method, simply call it on the LocalDate class and pass it the epoch-day count. The method will return a new LocalDate instance based on the epoch-day count.

LocalDate date = LocalDate.ofEpochDay(10);

Getting a date 10 days ahead

Let's take an example to get a date 10 days ahead by using ofEpochDay() method. Here, we passed 10 days to the method and get a new LocalDate instance.

public class LocalDateofEpochDay {
    public static void main(String[] args) {
        // get a date 10 days ahead
        LocalDate date = LocalDate.ofEpochDay(10);
        System.out.println(date); // output: 1970-01-11
    }
}

To run the code, compile the file using the following command:

javac LocalDateofEpochDay.java

Then run the compiled class file using the following command:

java LocalDateofEpochDay

Getting a date ahead of 1 year

Here, we are getting a date ahead of 1 year by adding 365 epoch days.

public class LocalDateofEpochDay {
    public static void main(String[] args) {
        // get a date ahead of 1 year
        LocalDate date = LocalDate.ofEpochDay(365);
        System.out.println(date); // output: 1971-01-01
    }
}

To run the code, compile the file using the following command:

javac LocalDateofEpochDay.java

Then run the compiled class file using the following command:

java LocalDateofEpochDay

Summary

In this lab, we learned about the Java LocalDate ofEpochDay() method. We saw how to use this method to get a LocalDate from the epoch-day count. We created two examples to see how adding an epoch day calculates the correct date.

Java LocalDate ofEpochDay Method