w3resource

MySQL CONVERT_TZ() function

CONVERT_TZ() function

In MySQL the CONVERT_TZ() returns a resulting value after converting a datetime value from a time zone specified as the second argument to the time zone specified as the third argument. This function returns NULL when the arguments are invalid.

Syntax:

CONVERT_TZ (dt, from_tz,to_tz)

Arguments :

Name Description
dt A datetime.
from_tz A time zone which will be converted to to_tz.
to_tz A time zone in which the from_tz will convert.

Syntax Diagram:

MySQL CONVERT_TZ() Function - Syntax Diagram

MySQL Version: 5.6


Video Presentation

Pictorial Presentation

Pictorial Presentation of MySQL CONVERT_TZ() function

Example: MySQL CONVERT_TZ() function

The following statement will convert the datetime value 2008-05-15 12:00:00 from +00:00 timezone to +10:00 timezone.

Code:

SELECT CONVERT_TZ('2008-05-15 12:00:00','+00:00','+10:00');

Sample Output:

mysql> SELECT CONVERT_TZ('2008-05-15 12:00:00','+00:00','+10:00');
+-----------------------------------------------------+
| CONVERT_TZ('2008-05-15 12:00:00','+00:00','+10:00') |
+-----------------------------------------------------+
| 2008-05-15 22:00:00                                 | 
+-----------------------------------------------------+
1 row in set (0.02 sec)

PHP script

<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>example-CONVERT_TZ-function - php mysql examples | w3resource</title>
<meta name="description" content="example-CONVERT_TZ-function - php mysql examples | w3resource">
<link rel="stylesheet" href="https://maxcdn.bootstrapcdn.com/bootstrap/3.3.5/css/bootstrap.min.css">
</head>
<body>
<div class="container">
<div class="row">
<div class="col-md-12">
<h2>Calculating a datetime, converting 2008-05-15 12:00:00 to a time zone which is ten hours ahead using MySQL:</h2>
<table class='table table-bordered'>
<tr> 
<th>Required Date</th>
</tr>
<?php
$hostname="your_hostname";
$username="your_username";
$password="your_password"; 
$db = "your_dbname";
$dbh = new PDO("mysql:host=$hostname;dbname=$db", $username, $password);
foreach($dbh->query('SELECT CONVERT_TZ("2008-05-15 12:00:00","+00:00","+10:00") as required_datetime') as $row) {
echo "<tr>";
echo "<td>" . $row['required_datetime'] . "</td>";
echo "</tr>";
}
?>
</tbody></table>
</div>
</div>
</div>
</body>
</html>

View the example in browser

JSP script

<%@page contentType="text/html" pageEncoding="UTF-8"%>
<%@ page import="java.sql.*" %>
<%@ page import="java.io.*" %>
<!DOCTYPE html>
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>example-convert_tz-function</title>
</head>
<body>
<%
try {
Class.forName("com.mysql.jdbc.Driver").newInstance();
String Host = "jdbc:mysql://localhost:3306/w3resour_bookinfo";
Connection connection = null;
Statement statement = null;
ResultSet rs = null;
connection = DriverManager.getConnection(Host, "root", "datasoft123");
statement = connection.createStatement();
String Data = "SELECT CONVERT_TZ('2008-05-15 12:00:00','+00:00','+10:00') as required_datetime";
rs = statement.executeQuery(Data);
%>
<TABLE border="1">
<tr width="10" bgcolor="#9979">
<td>Required Date</td>
</tr>
<%
while (rs.next()) {
%>
<TR>
<TD><%=rs.getString("required_datetime")%></TD>
</TR>
<%   }    %>
</table>
<%
rs.close();
statement.close();
connection.close();
} catch (Exception ex) {
out.println("Can’t connect to database.");
}
%>
</body>
</html>

All Date and Time Functions :

Click here to see the MySQL Date and time functions.

Previous: ADDTIME()
Next: CURDATE()