aqDateTime.Time Method

Applies to TestComplete 14.71, last modified on April 22, 2021

Description

Use the aqDateTime.Time method to get the current time. The resulting Date/Time value contains only the time portion.

To get both the current date and time, use the Now method. To get just the current date without time, use the Today method.

Declaration

aqDateTime.Time()

Result Date/Time

Applies To

The method is applied to the following object:

Result Value

A Date/Time value that contains the current time.

In JavaScript, JScript, Python or DelphiScript, if you try to output the date and time returned by the Time method as a string, conversion takes place and the date and time are output in the native format for the selected language (day/month/date/time/year in JavaScript, JScript and DelphiScript, year/month/day/time in Python). For example, this happens if you use the following code to post the current time to the test log:

JavaScript, JScript

function Test()
{
  Log.Message("Current time: " + aqDateTime.Time());
}

Python

def Test():
  Log.Message("Current time: " + str(aqDateTime.Time()))

VBScript

Sub Test
  Log.Message("Current time: " & aqDateTime.Time)
End Sub

DelphiScript

function Test;
begin
  Log.Message('Current time: ' + aqDateTime.Time);
end;

C++Script, C#Script

procedure Test()
{
  Log["Message"]("Current time: " + aqDateTime["Time"]());
}

To avoid such a conversion, you need to explicitly specify the format in which time should be displayed. For example, you can use the following code:

JavaScript, JScript

function Test()
{
  Log.Message("Current time: " + aqConvert.DateTimeToFormatStr(aqDateTime.Time(), "%H:%M:%S"));
}

Python

def Test2():
  Log.Message("Current time: " + aqConvert.DateTimeToFormatStr(aqDateTime.Time(), "%H:%M:%S"))

VBScript

Sub Test
  Log.Message("Current time: " & aqConvert.DateTimeToFormatStr(aqDateTime.Time, "%H:%M:%S"))
End Sub

DelphiScript

procedure Test;
begin
  Log.Message('Current time :' + aqConvert.DateTimeToFormatStr(aqDateTime.Time, '%H:%M:%S'));
end;

C++Script, C#Script

function Test()
{
  Log["Message"]("Current time: " + aqConvert["DateTimeToFormatStr"](aqDateTime["Time"](), "%H:%M:%S"));
}

Example

The code below demonstrates how you can compare different date and time values.

JavaScript, JScript

function ComparingDates()
{
  var currentDateAndTime = aqDateTime.Now();
  var currentTime = aqDateTime.Time();
  var currentDate = aqDateTime.Today();

  Log.Message(currentDateAndTime);
  Log.Message(currentTime);
  Log.Message(currentDate);

  Log.Message(aqDateTime.Compare(currentDateAndTime, currentTime));
  // 1, because currentDateAndTime is later then currentTime

  Log.Message(aqDateTime.Compare(currentDateAndTime, currentDate));
  // 1, because currentDateAndTime is later then currentDate

  Log.Message(aqDateTime.Compare(currentTime, currentDate));
  // -1, because currentTime is earlier then currentDate
}

Python

def ComparingDates():
  currentDateAndTime = aqDateTime.Now()
  currentTime = aqDateTime.Time()
  currentDate = aqDateTime.Today()
  Log.Message(currentDateAndTime)
  Log.Message(currentTime)
  Log.Message(currentDate)
  Log.Message(aqDateTime.Compare(currentDateAndTime, currentTime))
  # 1, because currentDateAndTime is later then currentTime
  Log.Message(aqDateTime.Compare(currentDateAndTime, currentDate));
  # 1, because currentDateAndTime is later then currentDate
  Log.Message(aqDateTime.Compare(currentTime, currentDate));
  # -1, because currentTime is earlier then currentDate

VBScript

Sub ComparingDates
  Dim currentDateAndTime, currentTime, currentDate

  currentDateAndTime = aqDateTime.Now
  currentTime = aqDateTime.Time
  currentDate = aqDateTime.Today

  Log.Message(currentDateAndTime)
  Log.Message(currentTime)
  Log.Message(currentDate)

  Log.Message(aqDateTime.Compare(currentDateAndTime, currentTime))
  ' 1, because currentDateAndTime is later then currentTime

  Log.Message(aqDateTime.Compare(currentDateAndTime, currentDate))
  ' 1, because currentDateAndTime is later then currentDate

  Log.Message(aqDateTime.Compare(currentTime, currentDate))
  ' -1, because currentTime is earlier then currentDate
End Sub

DelphiScript

procedure ComparingDates;
var currentDateAndTime, currentTime, currentDate;
begin
  currentDateAndTime := aqDateTime.Now;
  currentTime := aqDateTime.Time;
  currentDate := aqDateTime.Today;

  Log.Message(currentDateAndTime);
  Log.Message(currentTime);
  Log.Message(currentDate);

  Log.Message(aqDateTime.Compare(currentDateAndTime, currentTime));
  // 1, because currentDateAndTime is later then currentTime

  Log.Message(aqDateTime.Compare(currentDateAndTime, currentDate));
  // 1, because currentDateAndTime is later then currentDate

  Log.Message(aqDateTime.Compare(currentTime, currentDate));
  // -1, because currentTime is earlier then currentDate
end;

C++Script, C#Script

function ComparingDates()
{
  var currentDateAndTime = aqDateTime["Now"]();
  var currentTime = aqDateTime["Time"]();
  var currentDate = aqDateTime["Today"]();

  Log["Message"](currentDateAndTime);
  Log["Message"](currentTime);
  Log["Message"](currentDate);

  Log["Message"](aqDateTime["Compare"](currentDateAndTime, currentTime));
  // 1, because currentDateAndTime is later then currentTime

  Log["Message"](aqDateTime["Compare"](currentDateAndTime, currentDate));
  // 1, because currentDateAndTime is later then currentDate

  Log["Message"](aqDateTime["Compare"](currentTime, currentDate));
  // -1, because currentTime is earlier then currentDate
}

See Also

Working With Dates
Working With Time
Now Method
Today Method

Highlight search results