Home  |  Delphi .net Home  |  System.DateTime  |  AddMonths Method
AddMonths  
Method  
Adds a number of months to the date/time
DateTime Class
System NameSpace
CF1.  Function AddMonths ( Months : Integer; ) : DateTime;
CF : Methods with this mark are Compact Framework Compatible
Description
Adds a number of Months to the current object datetime, returning the result.
 
You can subtract by specifying a negative number, or using the Subtract method.
Notes
Like a lot of datetime methods, the datetime object itself is not affected - the modified datetime is returned for assignment.
Microsoft MSDN Links
System
System.DateTime
 
 
A simple example
// Full Unit code.
// -------------------------------------------------------------
// Create a new WinForm application, double click the form to
// create an OnLoad event, and then replace the WinForm unit
// with this text.
 
unit WinForm;
 
interface
 
uses
  System.Drawing, System.Collections, System.ComponentModel,
System.Windows.Forms, System.Data;
 
type
  TWinForm = class(System.Windows.Forms.Form)
  \{REGION 'Designer Managed Code'\} // Note that REGION and ENREGION should be prefixed by a dollar sign
  strict private
    ///
    /// Required designer variable.
    ///

    Components: System.ComponentModel.Container;
    ///
    /// Required method for Designer support - do not modify
    /// the contents of this method with the code editor.
    ///

    procedure InitializeComponent;
    procedure TWinForm_Load(sender: System.Object; e: System.EventArgs);
  {ENDREGION}
  strict protected
    ///
    /// Clean up any resources being used.
    ///

    procedure Dispose(Disposing: Boolean); override;
  private
    { Private Declarations }
  public
    constructor Create;
  end;
 
  [assembly: RuntimeRequiredAttribute(TypeOf(TWinForm))]
 
implementation
 
\{REGION 'Windows Form Designer generated code'\}
///
/// Required method for Designer support -- do not modify
/// the contents of this method with the code editor.
///

 
 
procedure TWinForm.InitializeComponent;
begin
  //
  // TWinForm
  //
  Self.AutoScaleBaseSize := System.Drawing.Size.Create(5, 13);
  Self.ClientSize := System.Drawing.Size.Create(292, 266);
  Self.Name := 'TWinForm';
  Self.Text := 'WinForm';
  Include(Self.Load, Self.TWinForm_Load);
end;
{ENDREGION}
 
procedure TWinForm.Dispose(Disposing: Boolean);
begin
  if Disposing then
  begin
    if Components <> nil then
      Components.Dispose();
  end;
  inherited Dispose(Disposing);
end;
 
constructor TWinForm.Create;
begin
  inherited Create;
  //
  // Required for Windows Form Designer support
  //
  InitializeComponent;
  //
  // TODO: Add any constructor code after InitializeComponent call
  //
end;
 
procedure TWinForm.TWinForm_Load(sender: System.Object; e: System.EventArgs);
program Project1;
{$APPTYPE CONSOLE}

var
  time : DateTime;

begin
  time := Datetime.Create(2004, 6, 20, 08, 30, 0);  // 08:30 on June 20 2004

  Console.WriteLine('Time at the start    = {0:F}', time);

  time := time.AddMonths(10);

  Console.WriteLine('With 10 months added = {0:F}', time);

  Console.ReadLine;
end.
 
end.
Hide full unit code
  Time at the start    = 20 June 2004 08:30:00
  With 10 months added = 20 April 2005 08:30:00
 
 
Delphi Programming © Neil Moffatt All rights reserved.  |  Contact the author