<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>STRPTIME</title><link rel="stylesheet" href="styles.css" type="text/css" /><meta name="generator" content="DocBook XSL Stylesheets V1.69.1" /><link rel="start" href="index.html" title="Asterisk™: The Future of Telephony" /><link rel="up" href="asterisk-APP-E.html" title="Appendix E. Asterisk Dialplan Functions" /><link rel="prev" href="asterisk-APP-E-60.html" title="STRFTIME" /><link rel="next" href="asterisk-APP-E-62.html" title="TIMEOUT" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">STRPTIME</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="asterisk-APP-E-60.html">Prev</a> </td><th width="60%" align="center">Appendix E. Asterisk Dialplan Functions</th><td width="20%" align="right"> <a accesskey="n" href="asterisk-APP-E-62.html">Next</a></td></tr></table><hr /></div><div class="refentry" lang="en" xml:lang="en"><a id="asterisk-APP-E-61"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>STRPTIME — Converts a string into a date and time</p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><a id="I_programlisting_tt2815"></a><pre class="programlisting">STRPTIME(<em class="replaceable"><code>datetime</code></em>|<em class="replaceable"><code>timezone</code></em>|<em class="replaceable"><code>format</code></em>)</pre></div><div class="refsect1" lang="en" xml:lang="en"><a id="id4222188"></a><h2></h2><p><a id="I_indexterm_tt2816" class="indexterm"></a>Returns the epoch of the arbitrary date/time string
structured as described in the format.</p><p>The purpose of this function is to take a formatted date/time and
convert it back into seconds since the epoch (January 1st, 1970, at
midnight GMT), so that you may do calculations with it, or simply
convert it into some other date/time format.</p><p><code class="literal">STRPTIME</code> passes the string and
format directly to the underlying C library call <code class="literal">strptime(3)</code>, so check out that manpage for
more information. The <em class="replaceable"><code>timezone</code></em> parameter
should be the name of a directory/file in <code class="filename">/usr/share/zoneinfo</code> (e.g., <code class="filename">America/Chicago</code> or <code class="filename">America/New_York</code>).</p></div><div class="refsect1" lang="en" xml:lang="en"><a id="id4222249"></a><h2>See Also</h2><p>
<a href="asterisk-APP-E-60.html" title="STRFTIME">
<code class="literal">STRFTIME()</code>
</a>
</p></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="asterisk-APP-E-60.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="asterisk-APP-E.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="asterisk-APP-E-62.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top">STRFTIME </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> TIMEOUT</td></tr></table></div><div xmlns="" id="svn-footer"><hr /><p>You are reading <em>Asterisk: The Future of Telephony</em> (2nd Edition for Asterisk 1.4), by Jim van Meggelen, Jared Smith, and Leif Madsen.<br />
This work is licensed under the <a href="http://creativecommons.org/licenses/by-nc-nd/3.0/">Creative Commons Attribution-Noncommercial-No Derivative Works License v3.0</a>.<br />
To submit comments, corrections, or other contributions to the text, please visit <a href="http://oreilly.com/catalog/9780596510480/">http://www.oreilly.com/</a>.</p></div></body></html>
