Java LocalDateTime with()用法及代碼示例

在LocalDateTime類中，根據傳遞給它的參數，有兩種類型的with()方法。

with(TemporalAdjuster adjuster)

LocalDateTime類的with(TemporalAdjuster Adjuster)方法用於使用TemporalAdjuster調整此日期時間，並且在調整後返回調整後的日期時間的副本。使用指定的調整器策略對象進行調整。此LocalDateTime實例是不可變的，不受此方法調用的影響。一個簡單的調節器用於設置一個字段，例如Year字段，而更複雜的調節器可能將時間設置為一年的最後一天。

用法:

public LocalDateTime with(TemporalAdjuster adjuster)

參數：該方法接受調節器作為要使用的調節器的參數。

返回值：此方法基於此返回的LocalDateTime進行調整。

異常：此方法引發以下異常：

DateTimeException–如果無法進行調整。
ArithmeticException–如果發生數字溢出。

以下示例程序旨在說明with()方法：
示例1:

// Java program to demonstrate 
// LocalDateTime.with() method 
  
import java.time.*; 
import java.time.temporal.*; 
  
public class GFG { 
    public static void main(String[] args) 
    { 
  
        // create a LocalDateTime object 
        LocalDateTime local 
            = LocalDateTime.parse( 
                "2020-12-31T10:15:30"); 
  
        // print instance 
        System.out.println("LocalDateTime before"
                           + " adjustment: "
                           + local); 
  
        // apply with method of LocalDateTime class 
        LocalDateTime updatedlocal 
            = local.with(Month.OCTOBER) 
                  .with(TemporalAdjusters 
                            .firstDayOfMonth()); 
  
        // print instance 
        System.out.println("LocalDateTime after"
                           + " adjustment: "
                           + updatedlocal); 
    } 
}

輸出：

LocalDateTime before adjustment: 2020-12-31T10:15:30
LocalDateTime after adjustment: 2020-10-01T10:15:30

with(TemporalField field, long newValue)

LocalDateTime類的with(TemporalField field，long newValue)方法用於將LocalDateTime的指定字段設置為新值並返回新時間的副本。此方法可用於更改任何受支持的字段，例如年，日，月，小時，分鍾或秒。如果由於不支持該字段或其他原因而無法設置新值，則會引發異常。此LocalDateTime實例是不可變的，不受此方法調用的影響。

用法:

public LocalDateTime with(TemporalField field, long newValue)

參數：此方法接受作為結果中要設置的字段的field和作為結果中該字段的新值的newValue。

返回值：該方法基於此方法並使用指定的字段集返回LocalDateTime。

異常：此方法引發以下異常：

DateTimeException–如果無法進行調整。
UnsupportedTemporalTypeException–如果不支持該字段。
ArithmeticException–如果發生數字溢出。

以下示例程序旨在說明with()方法：
示例1:

// Java program to demonstrate 
// LocalDateTime.with() method 
  
import java.time.*; 
import java.time.temporal.*; 
  
public class GFG { 
    public static void main(String[] args) 
    { 
  
        // create a LocalDateTime object 
        LocalDateTime local 
            = LocalDateTime.parse( 
                "2021-01-01T19:55:30"); 
  
        // print instance 
        System.out.println("LocalDateTime before"
                           + " applying method: "
                           + local); 
  
        // apply with method of LocalDateTime class 
        LocalDateTime updatedlocal 
            = local.with(ChronoField.YEAR, 2017); 
  
        // print instance 
        System.out.println("LocalDateTime after"
                           + " applying method: "
                           + updatedlocal); 
    } 
}

輸出：

LocalDateTime before applying method: 2021-01-01T19:55:30
LocalDateTime after applying method: 2017-01-01T19:55:30

參考文獻：
https://docs.oracle.com/javase/10/docs/api/java/time/LocalDateTime.html#with(java.time.temporal.TemporalAdjuster)
https://docs.oracle.com/javase/10/docs/api/java/time/LocalDateTime.html#with(java.time.temporal.TemporalField，長)

相關用法

注：本文由純淨天空篩選整理自AmanSingh2210大神的英文原創作品 LocalDateTime with() Method in Java with Examples。非經特殊聲明，原始代碼版權歸原作者所有，本譯文未經允許或授權，請勿轉載或複製。