DateTime.AddMonths(Int32) Metode

Definisi

Ruang nama:

System

Rakitan:

System.Runtime.dll

Sumber:

DateTime.cs

Mengembalikan baru DateTime yang menambahkan jumlah bulan yang ditentukan ke nilai instans ini.

public:
 DateTime AddMonths(int months);

public DateTime AddMonths (int months);

member this.AddMonths : int -> DateTime

Public Function AddMonths (months As Integer) As DateTime

Parameter

months

Int32

Jumlah bulan. Parameternya months bisa negatif atau positif.

Mengembalikan

DateTime

Objek yang nilainya adalah jumlah tanggal dan waktu yang diwakili oleh instans ini dan months.

Pengecualian

ArgumentOutOfRangeException

DateTime Hasilnya kurang dari DateTime.MinValue atau lebih besar dari DateTime.MaxValue.

-atau-

months kurang dari -120.000 atau lebih besar dari 120.000.

Contoh

Contoh berikut menambahkan antara nol dan lima belas bulan ke hari terakhir Desember 2015. Dalam hal ini, metode AddMonths mengembalikan tanggal hari terakhir setiap bulan, dan berhasil menangani tahun kapabel.

using System;

public class Example
{
   public static void Main()
   {
      var dat = new DateTime(2015, 12, 31);
      for (int ctr = 0; ctr <= 15; ctr++)
         Console.WriteLine(dat.AddMonths(ctr).ToString("d"));
   }
}
// The example displays the following output:
//       12/31/2015
//       1/31/2016
//       2/29/2016
//       3/31/2016
//       4/30/2016
//       5/31/2016
//       6/30/2016
//       7/31/2016
//       8/31/2016
//       9/30/2016
//       10/31/2016
//       11/30/2016
//       12/31/2016
//       1/31/2017
//       2/28/2017
//       3/31/2017

open System

let dat = DateTime(2015, 12, 31)
for i = 0 to 15 do
    printfn $"{dat.AddMonths i:d}"

// The example displays the following output:
//       12/31/2015
//       1/31/2016
//       2/29/2016
//       3/31/2016
//       4/30/2016
//       5/31/2016
//       6/30/2016
//       7/31/2016
//       8/31/2016
//       9/30/2016
//       10/31/2016
//       11/30/2016
//       12/31/2016
//       1/31/2017
//       2/28/2017
//       3/31/2017

Module Example
   Public Sub Main()
      Dim dat As Date = #12/31/2015#
      For ctr As Integer = 0 To 15
         Console.WriteLine(dat.AddMonths(ctr).ToString("d"))
      Next
   End Sub
End Module
' The example displays the following output:
'       12/31/2015
'       1/31/2016
'       2/29/2016
'       3/31/2016
'       4/30/2016
'       5/31/2016
'       6/30/2016
'       7/31/2016
'       8/31/2016
'       9/30/2016
'       10/31/2016
'       11/30/2016
'       12/31/2016
'       1/31/2017
'       2/28/2017
'       3/31/2017

Keterangan

Metode ini tidak mengubah nilai objek ini DateTime . Sebaliknya, ia mengembalikan objek baru DateTime yang nilainya adalah hasil dari operasi ini.

Metode menghitung AddMonths bulan dan tahun yang dihasilkan, dengan mempertimbangkan tahun kampung dan jumlah hari dalam sebulan, lalu menyesuaikan bagian hari dari objek yang dihasilkan DateTime . Jika hari yang dihasilkan bukan hari yang valid pada bulan yang dihasilkan, hari terakhir yang valid pada bulan yang dihasilkan digunakan. Misalnya, 31 Maret + 1 bulan = 30 April, dan 31 Maret - 1 bulan = 28 Februari untuk tahun non-kampung dan 29 Februari untuk tahun kabut.

Bagian waktu hari dari objek yang dihasilkan DateTime tetap sama dengan instans ini.