Clase java.time.Period en Java

La clase Period Class en Java obtiene una cantidad o cantidad de tiempo en términos de años, meses y días. El tiempo obtenido es una cantidad de tiempo basada en fechas en el sistema de calendario ISO-8601, como ‘4 años, 5 meses y 6 días. Las unidades que se admiten durante un período son AÑOS, MESES y días. Estos tres campos siempre están presentes, pero se pueden establecer en cero.

Sintaxis: declaración de clase

public final class Period 
extends Object 
implements ChronoPeriod, Serializable

A continuación, todos los métodos con la acción realizada por ellos son los siguientes en el formato tabular son los siguientes:

Método Descripción
addTo(Temporal temporal) Este método agrega este período al objeto temporal especificado.
between(LocalDate startDateInclusive, LocalDate endDateExclusive) Este método obtiene un Período que consiste en el número de años, meses y días entre dos fechas.
es igual a (Objeto obj) Este método comprueba si este período es igual a otro período.
from(cantidad TemporalAmount) Este método obtiene una instancia de Período a partir de una cantidad temporal.
get(unidad TemporalUnit) Este método obtiene el valor de la unidad solicitada.
obtenerCronología() Este método obtiene la cronología de este período, que es el sistema de calendario ISO.
obtenerDías() Este método obtiene el número de días de este período.
obtenerMeses() Este método obtiene el número de meses de este período.
obtenerUnidades() Este método obtiene el conjunto de unidades soportadas por este período.
obteneraños() Este método obtiene el número de años de este período.
código hash() Este método devuelve un código hash para este período.
es Negativo() Este método comprueba si alguna de las tres unidades de este período es negativa.
es cero() Este método verifica si las tres unidades de este período son cero.
minus(Importe Temporal cantidad a restar) Este método devuelve una copia de este período con el período especificado restado.
minusDays(long daysToSubtract) Este método devuelve una copia de este período con los días especificados restados.
minusMonths (meses largos para restar) Este método devuelve una copia de este período con los meses especificados restados.
minusYears(long yearsToSubtract) Este método devuelve una copia de este período con los años especificados restados.
multiplicado por (int escalar) Este método devuelve una nueva instancia con cada elemento en este período multiplicado por el escalar especificado.
negado() Este método devuelve una nueva instancia con cada monto en este período negado.
normalizado() Este método devuelve una copia de este período con los años y meses normalizados.
de(int años, int meses, int días) Este método obtiene un Período que representa un número de años, meses y días.
ofDays(int días) Este método obtiene un Período que representa un número de días.
ofMonths(int meses) Este método obtiene un Período que representa un número de meses.
ofWeeks(int semanas) Este método obtiene un Período que representa un número de semanas.
ofYears(int años) Este método obtiene un Período que representa un número de años.
analizar (texto CharSequence) Este método obtiene un Período de una string de texto como PnYnMnD.
plus(TemporalAmount cantidad a agregar) Este método devuelve una copia de este período con el período especificado agregado.
plusDays(long daysToAdd) Este método devuelve una copia de este período con los días especificados agregados.
plusMonths (meses largos para agregar) Este método devuelve una copia de este período con los meses especificados agregados.
plusYears(long yearsToAdd) Este método devuelve una copia de este período con los años especificados agregados.
restarDe(Temporal temporal) Este método resta este período del objeto temporal especificado.
Enstringr() Este método genera este período como una string, como P6Y3M1D.
aTotalMeses() Este método obtiene el número total de meses en este período.
withDays(int días) Este método devuelve una copia de este período con la cantidad de días especificada. 
withMonths(int meses) Este método devuelve una copia de este período con la cantidad de meses especificada.
withYears(int años) Este método devuelve una copia de este período con la cantidad de años especificada.

Implementemos algunos de los métodos de esta clase.

Implementación:

Ejemplo 1

Java

// Java program to illustrate Period class
// demonstrate the methods of this class
// Methods - minus() and ofMonths()
 
// Importing Period class from
// java.time package
import java.time.Period;
 
// Main class
public class GFG {
    // Main driver method
    public static void main(String[] args)
    {
        // Obtaining period representing number of months
        // using ofmonhs() method by
        // creating object of period class
        Period p1 = Period.ofMonths(6);
 
        // minus() will return a copy of this period
        // with the specified period subtracted.
        Period p2 = p1.minus(Period.ofMonths(2));
 
        // Print and display on the console
        System.out.println(p2);
    }
}
Producción

P4M

Tomemos otro ejemplo para discutir más métodos, a saber:

Método 1: el método ofDays() de esta clase se usa para obtener un período a partir del número dado de días como parámetro. 

Sintaxis:

public static Period ofDays(int numberOfDays)

Parámetros: este método acepta un número de días de parámetro único, que es el número de días que se analizarán en un objeto de período.

Devoluciones: esta función devuelve el período que es el objeto Período analizado con el número dado de días.

Método 2: el método addTo() de esta clase agrega este Período al objeto temporal específico.

Sintaxis:

public Temporal addTo(Temporal temporal)

Parámetros: El objeto temporal a ajustar no debe ser nulo.

Tipo de devolución: un objeto del mismo tipo con el ajuste realizado.

Excepciones: este método genera excepciones de fecha y hora y aritmética.

Ejemplo 2

Java

// Java program to illustrate Period class
// demonstrate the methods of this class
// Methods like ofDays() and addTo()
 
// Importing all classes from java.time package
import java.time.*;
import java.time.temporal.Temporal;
 
// Main class
public class GFG {
 
    // Main driver method
    public static void main(String[] args)
    {
        // Getting a period representing number of days
        // using ofDays() method
        Period p = Period.ofDays(24);
 
        // Adding this period to the
        // temporal object i.e. temp
        Temporal temp = p.addTo(LocalDate.now());
 
        // Print and display on the console
        System.out.println(temp);
    }
}
Producción

2021-03-29

Publicación traducida automáticamente

Artículo escrito por GeeksforGeeks-1 y traducido por Barcelona Geeks. The original can be accessed here. Licence: CCBY-SA

Deja una respuesta

Tu dirección de correo electrónico no será publicada. Los campos obligatorios están marcados con *