pQuery.setTime

Signature: pQuery.setTime(parameterName, value)

Returns: ParameterizedQuery pQuery - this ParameterizedQuery object. To see what methods can be used on a ParameterizedQuery, refer to the 'Parameterized Query' functions.

Sets the parameterName to the given java.sql.Time value.

Note

The JDBC driver converts this to an SQL TIME value when it sends it to the database.

Note

The parameterName may include the parameter prefix character (colon ':' or at sign '@') but is not required. For example: ':fieldValue' and 'fieldValue' will reference the same named parameter.

Parameters

Type	Name	Description	Default
String	parameterName	the name of the parameter
String, Date, or Time	value	the value to use for parameterName

Example

// Create the pQuery object with the SQL to be called
var pQuery = qie.getParameterizedQuery(
   "update patient set visit_time = :dob_time where patient_id = 1"
);

// Example: value as String (HH:mm:ss format)
pQuery.setTime("dob_time", "07:15:00");

// Execute the query
var queryResult = pQuery.doQuery("EMR Database");


// Example: value as Date
pQuery = qie.getParameterizedQuery(
   "update patient set visit_time = :dob_time where patient_id = 1"
);

var timeFromDate = qie.deduceDate("2025-01-05 07:15:00"); // Date object
pQuery.setTime("dob_time", timeFromDate);

queryResult = pQuery.doQuery("EMR Database");


// Example: value as Time
pQuery = qie.getParameterizedQuery(
   "update patient set visit_time = :dob_time where patient_id = 1"
);

var sqlTime = new java.sql.Time(qie.getSystemTimeMilliseconds());
pQuery.setTime("dob_time", sqlTime);

queryResult = pQuery.doQuery("EMR Database");


// Example: parameterName with prefix and value as String
pQuery = qie.getParameterizedQuery(
   "update patient set visit_time = :dob_time where patient_id = 1"
);

pQuery.setTime(":dob_time", "12:30:45");

queryResult = pQuery.doQuery("EMR Database");