http://git-wip-us.apache.org/repos/asf/incubator-freemarker-site/blob/51c3b7e5/docs/api/freemarker/core/Environment.html ---------------------------------------------------------------------- diff --git a/docs/api/freemarker/core/Environment.html b/docs/api/freemarker/core/Environment.html index c2f4474..39469fb 100644 --- a/docs/api/freemarker/core/Environment.html +++ b/docs/api/freemarker/core/Environment.html @@ -2,10 +2,10 @@ <!-- NewPage --> <html lang="en"> <head> -<!-- Generated by javadoc (1.8.0_144) on Sun Oct 15 21:19:44 EDT 2017 --> +<!-- Generated by javadoc (1.8.0_144) on Sat Nov 11 19:25:48 CET 2017 --> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> <title>Environment (FreeMarker 2.3.27-incubating API)</title> -<meta name="date" content="2017-10-15"> +<meta name="date" content="2017-11-11"> <link rel="stylesheet" type="text/css" href="../../stylesheet.css" title="Style"> <script type="text/javascript" src="../../script.js"></script> </head> @@ -98,7 +98,7 @@ var activeTableTab = "activeTableTab"; </div> <div class="contentContainer"> <ul class="inheritance"> -<li><a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true"; title="class or interface in java.lang">java.lang.Object</a></li> +<li>java.lang.Object</li> <li> <ul class="inheritance"> <li><a href="../../freemarker/core/Configurable.html" title="class in freemarker.core">freemarker.core.Configurable</a></li> @@ -191,7 +191,7 @@ extends <a href="../../freemarker/core/Configurable.html" title="class in freema <tr class="altColor"> <td class="colOne"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#Environment-freemarker.template.Template-freemarker.template.TemplateHashModel-java.io.Writer-">Environment</a></span>(<a href="../../freemarker/template/Template.html" title="class in freemarker.template">Template</a> template, <a href="../../freemarker/template/TemplateHashModel.html" title="interface in freemarker.template">TemplateHashModel</a> rootDataModel, - <a href="http://docs.oracle.com/javase/8/docs/api/java/io/Writer.html?is-external=true"; title="class or interface in java.io">Writer</a> out)</code> </td> + java.io.Writer out)</code> </td> </tr> </table> </li> @@ -209,15 +209,15 @@ extends <a href="../../freemarker/core/Configurable.html" title="class in freema <th class="colLast" scope="col">Method and Description</th> </tr> <tr id="i0" class="altColor"> -<td class="colFirst"><code><a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true"; title="class or interface in java.lang">Object</a></code></td> -<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#Z:Z__getitem__-java.lang.String-">__getitem__</a></span>(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true"; title="class or interface in java.lang">String</a> key)</code> +<td class="colFirst"><code>java.lang.Object</code></td> +<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#Z:Z__getitem__-java.lang.String-">__getitem__</a></span>(java.lang.String key)</code> <div class="block">A hook that Jython uses.</div> </td> </tr> <tr id="i1" class="rowColor"> <td class="colFirst"><code>void</code></td> -<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#Z:Z__setitem__-java.lang.String-java.lang.Object-">__setitem__</a></span>(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true"; title="class or interface in java.lang">String</a> key, - <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true"; title="class or interface in java.lang">Object</a> o)</code> +<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#Z:Z__setitem__-java.lang.String-java.lang.Object-">__setitem__</a></span>(java.lang.String key, + java.lang.Object o)</code> <div class="block">A hook that Jython uses.</div> </td> </tr> @@ -265,9 +265,9 @@ extends <a href="../../freemarker/core/Configurable.html" title="class in freema </td> </tr> <tr id="i8" class="altColor"> -<td class="colFirst"><code><a href="http://docs.oracle.com/javase/8/docs/api/java/text/NumberFormat.html?is-external=true"; title="class or interface in java.text">NumberFormat</a></code></td> +<td class="colFirst"><code>java.text.NumberFormat</code></td> <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#getCNumberFormat--">getCNumberFormat</a></span>()</code> -<div class="block">Returns the <a href="http://docs.oracle.com/javase/8/docs/api/java/text/NumberFormat.html?is-external=true"; title="class or interface in java.text"><code>NumberFormat</code></a> used for the <tt>c</tt> built-in.</div> +<div class="block">Returns the <code>NumberFormat</code> used for the <tt>c</tt> built-in.</div> </td> </tr> <tr id="i9" class="rowColor"> @@ -305,8 +305,8 @@ extends <a href="../../freemarker/core/Configurable.html" title="class in freema <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#getCurrentVisitorNode--">getCurrentVisitorNode</a></span>()</code> </td> </tr> <tr id="i15" class="rowColor"> -<td class="colFirst"><code><a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true"; title="class or interface in java.lang">Object</a></code></td> -<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#getCustomState-java.lang.Object-">getCustomState</a></span>(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true"; title="class or interface in java.lang">Object</a> identityKey)</code> +<td class="colFirst"><code>java.lang.Object</code></td> +<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#getCustomState-java.lang.Object-">getCustomState</a></span>(java.lang.Object identityKey)</code> <div class="block">Returns the value of a custom state variable, or <code>null</code> if it's missing; see <a href="../../freemarker/core/Environment.html#setCustomState-java.lang.Object-java.lang.Object-"><code>setCustomState(Object, Object)</code></a> for more.</div> </td> @@ -314,11 +314,12 @@ extends <a href="../../freemarker/core/Configurable.html" title="class in freema <tr id="i16" class="altColor"> <td class="colFirst"><code><a href="../../freemarker/template/TemplateHashModel.html" title="interface in freemarker.template">TemplateHashModel</a></code></td> <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#getDataModel--">getDataModel</a></span>()</code> -<div class="block">Returns the data-model (also known as the template context in some other template engines).</div> +<div class="block">Returns a view of the data-model (also known as the template context in some other template engines) + that falls back to <a href="../../freemarker/template/Configuration.html#setSharedVariable-java.lang.String-freemarker.template.TemplateModel-">shared variables</a>.</div> </td> </tr> <tr id="i17" class="rowColor"> -<td class="colFirst"><code><a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true"; title="class or interface in java.lang">String</a></code></td> +<td class="colFirst"><code>java.lang.String</code></td> <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#getDefaultNS--">getDefaultNS</a></span>()</code> </td> </tr> <tr id="i18" class="altColor"> @@ -330,7 +331,7 @@ extends <a href="../../freemarker/core/Configurable.html" title="class in freema </tr> <tr id="i19" class="rowColor"> <td class="colFirst"><code><a href="../../freemarker/template/TemplateModel.html" title="interface in freemarker.template">TemplateModel</a></code></td> -<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#getGlobalVariable-java.lang.String-">getGlobalVariable</a></span>(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true"; title="class or interface in java.lang">String</a> name)</code> +<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#getGlobalVariable-java.lang.String-">getGlobalVariable</a></span>(java.lang.String name)</code> <div class="block">Returns the globally visible variable of the given name (or null).</div> </td> </tr> @@ -341,14 +342,14 @@ extends <a href="../../freemarker/core/Configurable.html" title="class in freema </td> </tr> <tr id="i21" class="rowColor"> -<td class="colFirst"><code><a href="http://docs.oracle.com/javase/8/docs/api/java/util/Set.html?is-external=true"; title="class or interface in java.util">Set</a></code></td> +<td class="colFirst"><code>java.util.Set</code></td> <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#getKnownVariableNames--">getKnownVariableNames</a></span>()</code> <div class="block">Returns a set of variable names that are known at the time of call.</div> </td> </tr> <tr id="i22" class="altColor"> <td class="colFirst"><code><a href="../../freemarker/template/TemplateModel.html" title="interface in freemarker.template">TemplateModel</a></code></td> -<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#getLocalVariable-java.lang.String-">getLocalVariable</a></span>(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true"; title="class or interface in java.lang">String</a> name)</code> +<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#getLocalVariable-java.lang.String-">getLocalVariable</a></span>(java.lang.String name)</code> <div class="block">Returns the loop or macro local variable corresponding to this variable name.</div> </td> </tr> @@ -366,21 +367,21 @@ extends <a href="../../freemarker/core/Configurable.html" title="class in freema </tr> <tr id="i25" class="rowColor"> <td class="colFirst"><code><a href="../../freemarker/core/Environment.Namespace.html" title="class in freemarker.core">Environment.Namespace</a></code></td> -<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#getNamespace-java.lang.String-">getNamespace</a></span>(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true"; title="class or interface in java.lang">String</a> name)</code> +<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#getNamespace-java.lang.String-">getNamespace</a></span>(java.lang.String name)</code> <div class="block">Returns the name-space for the name if exists, or null.</div> </td> </tr> <tr id="i26" class="altColor"> -<td class="colFirst"><code><a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true"; title="class or interface in java.lang">String</a></code></td> -<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#getNamespaceForPrefix-java.lang.String-">getNamespaceForPrefix</a></span>(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true"; title="class or interface in java.lang">String</a> prefix)</code> </td> +<td class="colFirst"><code>java.lang.String</code></td> +<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#getNamespaceForPrefix-java.lang.String-">getNamespaceForPrefix</a></span>(java.lang.String prefix)</code> </td> </tr> <tr id="i27" class="rowColor"> -<td class="colFirst"><code><a href="http://docs.oracle.com/javase/8/docs/api/java/io/Writer.html?is-external=true"; title="class or interface in java.io">Writer</a></code></td> +<td class="colFirst"><code>java.io.Writer</code></td> <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#getOut--">getOut</a></span>()</code> </td> </tr> <tr id="i28" class="altColor"> -<td class="colFirst"><code><a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true"; title="class or interface in java.lang">String</a></code></td> -<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#getPrefixForNamespace-java.lang.String-">getPrefixForNamespace</a></span>(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true"; title="class or interface in java.lang">String</a> nsURI)</code> </td> +<td class="colFirst"><code>java.lang.String</code></td> +<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#getPrefixForNamespace-java.lang.String-">getPrefixForNamespace</a></span>(java.lang.String nsURI)</code> </td> </tr> <tr id="i29" class="rowColor"> <td class="colFirst"><code><a href="../../freemarker/template/Template.html" title="class in freemarker.template">Template</a></code></td> @@ -395,61 +396,61 @@ extends <a href="../../freemarker/core/Configurable.html" title="class in freema <tr id="i30" class="altColor"> <td class="colFirst"><code><a href="../../freemarker/core/TemplateDateFormat.html" title="class in freemarker.core">TemplateDateFormat</a></code></td> <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#getTemplateDateFormat-int-java.lang.Class-">getTemplateDateFormat</a></span>(int dateType, - <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Class.html?is-external=true"; title="class or interface in java.lang">Class</a><? extends <a href="http://docs.oracle.com/javase/8/docs/api/java/util/Date.html?is-external=true"; title="class or interface in java.util">Date</a>> dateClass)</code> + java.lang.Class<? extends java.util.Date> dateClass)</code> <div class="block">Gets a <a href="../../freemarker/core/TemplateDateFormat.html" title="class in freemarker.core"><code>TemplateDateFormat</code></a> using the date/time/datetime format settings and the current locale and time zone.</div> </td> </tr> <tr id="i31" class="rowColor"> <td class="colFirst"><code><a href="../../freemarker/core/TemplateDateFormat.html" title="class in freemarker.core">TemplateDateFormat</a></code></td> -<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#getTemplateDateFormat-java.lang.String-int-java.lang.Class-">getTemplateDateFormat</a></span>(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true"; title="class or interface in java.lang">String</a> formatString, +<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#getTemplateDateFormat-java.lang.String-int-java.lang.Class-">getTemplateDateFormat</a></span>(java.lang.String formatString, int dateType, - <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Class.html?is-external=true"; title="class or interface in java.lang">Class</a><? extends <a href="http://docs.oracle.com/javase/8/docs/api/java/util/Date.html?is-external=true"; title="class or interface in java.util">Date</a>> dateClass)</code> + java.lang.Class<? extends java.util.Date> dateClass)</code> <div class="block">Gets a <a href="../../freemarker/core/TemplateDateFormat.html" title="class in freemarker.core"><code>TemplateDateFormat</code></a> for the specified format string and the current locale and time zone.</div> </td> </tr> <tr id="i32" class="altColor"> <td class="colFirst"><code><a href="../../freemarker/core/TemplateDateFormat.html" title="class in freemarker.core">TemplateDateFormat</a></code></td> -<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#getTemplateDateFormat-java.lang.String-int-java.lang.Class-java.util.Locale-">getTemplateDateFormat</a></span>(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true"; title="class or interface in java.lang">String</a> formatString, +<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#getTemplateDateFormat-java.lang.String-int-java.lang.Class-java.util.Locale-">getTemplateDateFormat</a></span>(java.lang.String formatString, int dateType, - <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Class.html?is-external=true"; title="class or interface in java.lang">Class</a><? extends <a href="http://docs.oracle.com/javase/8/docs/api/java/util/Date.html?is-external=true"; title="class or interface in java.util">Date</a>> dateClass, - <a href="http://docs.oracle.com/javase/8/docs/api/java/util/Locale.html?is-external=true"; title="class or interface in java.util">Locale</a> locale)</code> + java.lang.Class<? extends java.util.Date> dateClass, + java.util.Locale locale)</code> <div class="block">Like <a href="../../freemarker/core/Environment.html#getTemplateDateFormat-java.lang.String-int-java.lang.Class-"><code>getTemplateDateFormat(String, int, Class)</code></a>, but allows you to use a different locale than the current one.</div> </td> </tr> <tr id="i33" class="rowColor"> <td class="colFirst"><code><a href="../../freemarker/core/TemplateDateFormat.html" title="class in freemarker.core">TemplateDateFormat</a></code></td> -<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#getTemplateDateFormat-java.lang.String-int-java.lang.Class-java.util.Locale-java.util.TimeZone-java.util.TimeZone-">getTemplateDateFormat</a></span>(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true"; title="class or interface in java.lang">String</a> formatString, +<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#getTemplateDateFormat-java.lang.String-int-java.lang.Class-java.util.Locale-java.util.TimeZone-java.util.TimeZone-">getTemplateDateFormat</a></span>(java.lang.String formatString, int dateType, - <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Class.html?is-external=true"; title="class or interface in java.lang">Class</a><? extends <a href="http://docs.oracle.com/javase/8/docs/api/java/util/Date.html?is-external=true"; title="class or interface in java.util">Date</a>> dateClass, - <a href="http://docs.oracle.com/javase/8/docs/api/java/util/Locale.html?is-external=true"; title="class or interface in java.util">Locale</a> locale, - <a href="http://docs.oracle.com/javase/8/docs/api/java/util/TimeZone.html?is-external=true"; title="class or interface in java.util">TimeZone</a> timeZone, - <a href="http://docs.oracle.com/javase/8/docs/api/java/util/TimeZone.html?is-external=true"; title="class or interface in java.util">TimeZone</a> sqlDateAndTimeTimeZone)</code> + java.lang.Class<? extends java.util.Date> dateClass, + java.util.Locale locale, + java.util.TimeZone timeZone, + java.util.TimeZone sqlDateAndTimeTimeZone)</code> <div class="block">Like <a href="../../freemarker/core/Environment.html#getTemplateDateFormat-java.lang.String-int-java.lang.Class-"><code>getTemplateDateFormat(String, int, Class)</code></a>, but allows you to use a different locale and time zone than the current one.</div> </td> </tr> <tr id="i34" class="altColor"> <td class="colFirst"><code><a href="../../freemarker/core/TemplateDateFormat.html" title="class in freemarker.core">TemplateDateFormat</a></code></td> -<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#getTemplateDateFormat-java.lang.String-int-java.util.Locale-java.util.TimeZone-boolean-">getTemplateDateFormat</a></span>(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true"; title="class or interface in java.lang">String</a> formatString, +<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#getTemplateDateFormat-java.lang.String-int-java.util.Locale-java.util.TimeZone-boolean-">getTemplateDateFormat</a></span>(java.lang.String formatString, int dateType, - <a href="http://docs.oracle.com/javase/8/docs/api/java/util/Locale.html?is-external=true"; title="class or interface in java.util">Locale</a> locale, - <a href="http://docs.oracle.com/javase/8/docs/api/java/util/TimeZone.html?is-external=true"; title="class or interface in java.util">TimeZone</a> timeZone, + java.util.Locale locale, + java.util.TimeZone timeZone, boolean zonelessInput)</code> <div class="block">Gets a <a href="../../freemarker/core/TemplateDateFormat.html" title="class in freemarker.core"><code>TemplateDateFormat</code></a> for the specified parameters.</div> </td> </tr> <tr id="i35" class="rowColor"> <td class="colFirst"><code><a href="../../freemarker/template/Template.html" title="class in freemarker.template">Template</a></code></td> -<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#getTemplateForImporting-java.lang.String-">getTemplateForImporting</a></span>(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true"; title="class or interface in java.lang">String</a> name)</code> +<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#getTemplateForImporting-java.lang.String-">getTemplateForImporting</a></span>(java.lang.String name)</code> <div class="block">Gets a template for importing; used with <a href="../../freemarker/core/Environment.html#importLib-freemarker.template.Template-java.lang.String-"><code>importLib(Template importedTemplate, String namespace)</code></a>.</div> </td> </tr> <tr id="i36" class="altColor"> <td class="colFirst"><code><a href="../../freemarker/template/Template.html" title="class in freemarker.template">Template</a></code></td> -<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#getTemplateForInclusion-java.lang.String-java.lang.String-boolean-">getTemplateForInclusion</a></span>(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true"; title="class or interface in java.lang">String</a> name, - <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true"; title="class or interface in java.lang">String</a> encoding, +<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#getTemplateForInclusion-java.lang.String-java.lang.String-boolean-">getTemplateForInclusion</a></span>(java.lang.String name, + java.lang.String encoding, boolean parse)</code> <div class="block">Same as <a href="../../freemarker/core/Environment.html#getTemplateForInclusion-java.lang.String-java.lang.String-boolean-boolean-"><code>getTemplateForInclusion(String, String, boolean, boolean)</code></a> with <code>false</code> <code>ignoreMissing</code> argument.</div> @@ -457,8 +458,8 @@ extends <a href="../../freemarker/core/Configurable.html" title="class in freema </tr> <tr id="i37" class="rowColor"> <td class="colFirst"><code><a href="../../freemarker/template/Template.html" title="class in freemarker.template">Template</a></code></td> -<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#getTemplateForInclusion-java.lang.String-java.lang.String-boolean-boolean-">getTemplateForInclusion</a></span>(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true"; title="class or interface in java.lang">String</a> name, - <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true"; title="class or interface in java.lang">String</a> encoding, +<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#getTemplateForInclusion-java.lang.String-java.lang.String-boolean-boolean-">getTemplateForInclusion</a></span>(java.lang.String name, + java.lang.String encoding, boolean parseAsFTL, boolean ignoreMissing)</code> <div class="block">Gets a template for inclusion; used for implementing <a href="../../freemarker/core/Environment.html#include-freemarker.template.Template-"><code>include(Template includedTemplate)</code></a>.</div> @@ -472,34 +473,34 @@ extends <a href="../../freemarker/core/Configurable.html" title="class in freema </tr> <tr id="i39" class="rowColor"> <td class="colFirst"><code><a href="../../freemarker/core/TemplateNumberFormat.html" title="class in freemarker.core">TemplateNumberFormat</a></code></td> -<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#getTemplateNumberFormat-java.lang.String-">getTemplateNumberFormat</a></span>(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true"; title="class or interface in java.lang">String</a> formatString)</code> +<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#getTemplateNumberFormat-java.lang.String-">getTemplateNumberFormat</a></span>(java.lang.String formatString)</code> <div class="block">Returns the number format as <a href="../../freemarker/core/TemplateNumberFormat.html" title="class in freemarker.core"><code>TemplateNumberFormat</code></a> for the given format string and the current locale.</div> </td> </tr> <tr id="i40" class="altColor"> <td class="colFirst"><code><a href="../../freemarker/core/TemplateNumberFormat.html" title="class in freemarker.core">TemplateNumberFormat</a></code></td> -<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#getTemplateNumberFormat-java.lang.String-java.util.Locale-">getTemplateNumberFormat</a></span>(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true"; title="class or interface in java.lang">String</a> formatString, - <a href="http://docs.oracle.com/javase/8/docs/api/java/util/Locale.html?is-external=true"; title="class or interface in java.util">Locale</a> locale)</code> +<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#getTemplateNumberFormat-java.lang.String-java.util.Locale-">getTemplateNumberFormat</a></span>(java.lang.String formatString, + java.util.Locale locale)</code> <div class="block">Returns the number format as <a href="../../freemarker/core/TemplateNumberFormat.html" title="class in freemarker.core"><code>TemplateNumberFormat</code></a>, for the given format string and locale.</div> </td> </tr> <tr id="i41" class="rowColor"> <td class="colFirst"><code><a href="../../freemarker/template/TemplateModel.html" title="interface in freemarker.template">TemplateModel</a></code></td> -<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#getVariable-java.lang.String-">getVariable</a></span>(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true"; title="class or interface in java.lang">String</a> name)</code> +<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#getVariable-java.lang.String-">getVariable</a></span>(java.lang.String name)</code> <div class="block">Returns the variable that is visible in this context, or <code>null</code> if the variable is not found.</div> </td> </tr> <tr id="i42" class="altColor"> <td class="colFirst"><code><a href="../../freemarker/core/Environment.Namespace.html" title="class in freemarker.core">Environment.Namespace</a></code></td> -<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#importLib-java.lang.String-java.lang.String-">importLib</a></span>(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true"; title="class or interface in java.lang">String</a> templateName, - <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true"; title="class or interface in java.lang">String</a> targetNsVarName)</code> +<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#importLib-java.lang.String-java.lang.String-">importLib</a></span>(java.lang.String templateName, + java.lang.String targetNsVarName)</code> <div class="block">Emulates <code>import</code> directive, except that <code>templateName</code> must be template root relative.</div> </td> </tr> <tr id="i43" class="rowColor"> <td class="colFirst"><code><a href="../../freemarker/core/Environment.Namespace.html" title="class in freemarker.core">Environment.Namespace</a></code></td> -<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#importLib-java.lang.String-java.lang.String-boolean-">importLib</a></span>(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true"; title="class or interface in java.lang">String</a> templateName, - <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true"; title="class or interface in java.lang">String</a> targetNsVarName, +<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#importLib-java.lang.String-java.lang.String-boolean-">importLib</a></span>(java.lang.String templateName, + java.lang.String targetNsVarName, boolean lazy)</code> <div class="block">Like <a href="../../freemarker/core/Environment.html#importLib-java.lang.String-java.lang.String-"><code>importLib(String, String)</code></a>, but you can specify if you want a <a href="../../freemarker/core/Configurable.html#setLazyImports-boolean-">lazy import</a> or not.</div> @@ -508,14 +509,14 @@ extends <a href="../../freemarker/core/Configurable.html" title="class in freema <tr id="i44" class="altColor"> <td class="colFirst"><code><a href="../../freemarker/core/Environment.Namespace.html" title="class in freemarker.core">Environment.Namespace</a></code></td> <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#importLib-freemarker.template.Template-java.lang.String-">importLib</a></span>(<a href="../../freemarker/template/Template.html" title="class in freemarker.template">Template</a> loadedTemplate, - <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true"; title="class or interface in java.lang">String</a> targetNsVarName)</code> + java.lang.String targetNsVarName)</code> <div class="block">Does what the <code>#import</code> directive does, but with an already loaded template.</div> </td> </tr> <tr id="i45" class="rowColor"> <td class="colFirst"><code>void</code></td> -<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#include-java.lang.String-java.lang.String-boolean-">include</a></span>(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true"; title="class or interface in java.lang">String</a> name, - <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true"; title="class or interface in java.lang">String</a> encoding, +<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#include-java.lang.String-java.lang.String-boolean-">include</a></span>(java.lang.String name, + java.lang.String encoding, boolean parse)</code> <div class="block">Emulates <code>include</code> directive, except that <code>name</code> must be template root relative.</div> </td> @@ -535,7 +536,7 @@ extends <a href="../../freemarker/core/Configurable.html" title="class in freema </tr> <tr id="i48" class="altColor"> <td class="colFirst"><code>void</code></td> -<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#outputInstructionStack-java.io.PrintWriter-">outputInstructionStack</a></span>(<a href="http://docs.oracle.com/javase/8/docs/api/java/io/PrintWriter.html?is-external=true"; title="class or interface in java.io">PrintWriter</a> pw)</code> +<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#outputInstructionStack-java.io.PrintWriter-">outputInstructionStack</a></span>(java.io.PrintWriter pw)</code> <div class="block">Prints the current FTL stack trace.</div> </td> </tr> @@ -552,68 +553,68 @@ extends <a href="../../freemarker/core/Configurable.html" title="class in freema </td> </tr> <tr id="i51" class="rowColor"> -<td class="colFirst"><code><a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true"; title="class or interface in java.lang">Object</a></code></td> -<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#setCustomState-java.lang.Object-java.lang.Object-">setCustomState</a></span>(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true"; title="class or interface in java.lang">Object</a> identityKey, - <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true"; title="class or interface in java.lang">Object</a> value)</code> +<td class="colFirst"><code>java.lang.Object</code></td> +<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#setCustomState-java.lang.Object-java.lang.Object-">setCustomState</a></span>(java.lang.Object identityKey, + java.lang.Object value)</code> <div class="block">Sets the value of a custom state variable.</div> </td> </tr> <tr id="i52" class="altColor"> <td class="colFirst"><code>void</code></td> -<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#setDateFormat-java.lang.String-">setDateFormat</a></span>(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true"; title="class or interface in java.lang">String</a> dateFormat)</code> -<div class="block">Sets the format used to convert <a href="http://docs.oracle.com/javase/8/docs/api/java/util/Date.html?is-external=true"; title="class or interface in java.util"><code>Date</code></a>-s that are date-only (no time part) values to string-s, +<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#setDateFormat-java.lang.String-">setDateFormat</a></span>(java.lang.String dateFormat)</code> +<div class="block">Sets the format used to convert <code>Date</code>-s that are date-only (no time part) values to string-s, also the format that <code>someString?date</code> will use to parse strings.</div> </td> </tr> <tr id="i53" class="rowColor"> <td class="colFirst"><code>void</code></td> -<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#setDateTimeFormat-java.lang.String-">setDateTimeFormat</a></span>(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true"; title="class or interface in java.lang">String</a> dateTimeFormat)</code> -<div class="block">Sets the format used to convert <a href="http://docs.oracle.com/javase/8/docs/api/java/util/Date.html?is-external=true"; title="class or interface in java.util"><code>Date</code></a>-s that are date-time (timestamp) values to string-s, +<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#setDateTimeFormat-java.lang.String-">setDateTimeFormat</a></span>(java.lang.String dateTimeFormat)</code> +<div class="block">Sets the format used to convert <code>Date</code>-s that are date-time (timestamp) values to string-s, also the format that <code>someString?datetime</code> will use to parse strings.</div> </td> </tr> <tr id="i54" class="altColor"> <td class="colFirst"><code>void</code></td> -<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#setGlobalVariable-java.lang.String-freemarker.template.TemplateModel-">setGlobalVariable</a></span>(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true"; title="class or interface in java.lang">String</a> name, +<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#setGlobalVariable-java.lang.String-freemarker.template.TemplateModel-">setGlobalVariable</a></span>(java.lang.String name, <a href="../../freemarker/template/TemplateModel.html" title="interface in freemarker.template">TemplateModel</a> model)</code> <div class="block">Sets a variable that is visible globally.</div> </td> </tr> <tr id="i55" class="rowColor"> <td class="colFirst"><code>void</code></td> -<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#setLocale-java.util.Locale-">setLocale</a></span>(<a href="http://docs.oracle.com/javase/8/docs/api/java/util/Locale.html?is-external=true"; title="class or interface in java.util">Locale</a> locale)</code> +<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#setLocale-java.util.Locale-">setLocale</a></span>(java.util.Locale locale)</code> <div class="block">Sets the locale used for number and date formatting (among others), also the locale used for searching localized template variations when no locale was explicitly requested.</div> </td> </tr> <tr id="i56" class="altColor"> <td class="colFirst"><code>void</code></td> -<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#setLocalVariable-java.lang.String-freemarker.template.TemplateModel-">setLocalVariable</a></span>(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true"; title="class or interface in java.lang">String</a> name, +<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#setLocalVariable-java.lang.String-freemarker.template.TemplateModel-">setLocalVariable</a></span>(java.lang.String name, <a href="../../freemarker/template/TemplateModel.html" title="interface in freemarker.template">TemplateModel</a> model)</code> <div class="block">Sets a local variable (one effective only during a macro invocation).</div> </td> </tr> <tr id="i57" class="rowColor"> <td class="colFirst"><code>void</code></td> -<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#setNumberFormat-java.lang.String-">setNumberFormat</a></span>(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true"; title="class or interface in java.lang">String</a> formatName)</code> +<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#setNumberFormat-java.lang.String-">setNumberFormat</a></span>(java.lang.String formatName)</code> <div class="block">Sets the default number format used to convert numbers to strings.</div> </td> </tr> <tr id="i58" class="altColor"> <td class="colFirst"><code>void</code></td> -<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#setOut-java.io.Writer-">setOut</a></span>(<a href="http://docs.oracle.com/javase/8/docs/api/java/io/Writer.html?is-external=true"; title="class or interface in java.io">Writer</a> out)</code> </td> +<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#setOut-java.io.Writer-">setOut</a></span>(java.io.Writer out)</code> </td> </tr> <tr id="i59" class="rowColor"> <td class="colFirst"><code>void</code></td> -<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#setOutputEncoding-java.lang.String-">setOutputEncoding</a></span>(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true"; title="class or interface in java.lang">String</a> outputEncoding)</code> +<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#setOutputEncoding-java.lang.String-">setOutputEncoding</a></span>(java.lang.String outputEncoding)</code> <div class="block">Informs FreeMarker about the charset used for the output.</div> </td> </tr> <tr id="i60" class="altColor"> <td class="colFirst"><code>void</code></td> -<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#setSQLDateAndTimeTimeZone-java.util.TimeZone-">setSQLDateAndTimeTimeZone</a></span>(<a href="http://docs.oracle.com/javase/8/docs/api/java/util/TimeZone.html?is-external=true"; title="class or interface in java.util">TimeZone</a> timeZone)</code> -<div class="block">Sets the time zone used when dealing with <a href="http://docs.oracle.com/javase/8/docs/api/java/sql/Date.html?is-external=true"; title="class or interface in java.sql"><code>java.sql.Date</code></a> and - <a href="http://docs.oracle.com/javase/8/docs/api/java/sql/Time.html?is-external=true"; title="class or interface in java.sql"><code>java.sql.Time</code></a> values.</div> +<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#setSQLDateAndTimeTimeZone-java.util.TimeZone-">setSQLDateAndTimeTimeZone</a></span>(java.util.TimeZone timeZone)</code> +<div class="block">Sets the time zone used when dealing with <code>java.sql.Date</code> and + <code>java.sql.Time</code> values.</div> </td> </tr> <tr id="i61" class="rowColor"> @@ -624,34 +625,34 @@ extends <a href="../../freemarker/core/Configurable.html" title="class in freema </tr> <tr id="i62" class="altColor"> <td class="colFirst"><code>void</code></td> -<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#setTimeFormat-java.lang.String-">setTimeFormat</a></span>(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true"; title="class or interface in java.lang">String</a> timeFormat)</code> -<div class="block">Sets the format used to convert <a href="http://docs.oracle.com/javase/8/docs/api/java/util/Date.html?is-external=true"; title="class or interface in java.util"><code>Date</code></a>-s that are time (no date part) values to string-s, also +<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#setTimeFormat-java.lang.String-">setTimeFormat</a></span>(java.lang.String timeFormat)</code> +<div class="block">Sets the format used to convert <code>Date</code>-s that are time (no date part) values to string-s, also the format that <code>someString?time</code> will use to parse strings.</div> </td> </tr> <tr id="i63" class="rowColor"> <td class="colFirst"><code>void</code></td> -<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#setTimeZone-java.util.TimeZone-">setTimeZone</a></span>(<a href="http://docs.oracle.com/javase/8/docs/api/java/util/TimeZone.html?is-external=true"; title="class or interface in java.util">TimeZone</a> timeZone)</code> +<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#setTimeZone-java.util.TimeZone-">setTimeZone</a></span>(java.util.TimeZone timeZone)</code> <div class="block">Sets the time zone to use when formatting date/time values.</div> </td> </tr> <tr id="i64" class="altColor"> <td class="colFirst"><code>void</code></td> -<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#setURLEscapingCharset-java.lang.String-">setURLEscapingCharset</a></span>(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true"; title="class or interface in java.lang">String</a> urlEscapingCharset)</code> +<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#setURLEscapingCharset-java.lang.String-">setURLEscapingCharset</a></span>(java.lang.String urlEscapingCharset)</code> <div class="block">Sets the URL escaping (URL encoding, percentage encoding) charset.</div> </td> </tr> <tr id="i65" class="rowColor"> <td class="colFirst"><code>void</code></td> -<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#setVariable-java.lang.String-freemarker.template.TemplateModel-">setVariable</a></span>(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true"; title="class or interface in java.lang">String</a> name, +<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#setVariable-java.lang.String-freemarker.template.TemplateModel-">setVariable</a></span>(java.lang.String name, <a href="../../freemarker/template/TemplateModel.html" title="interface in freemarker.template">TemplateModel</a> model)</code> <div class="block">Sets a variable in the current namespace.</div> </td> </tr> <tr id="i66" class="altColor"> -<td class="colFirst"><code><a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true"; title="class or interface in java.lang">String</a></code></td> -<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#toFullTemplateName-java.lang.String-java.lang.String-">toFullTemplateName</a></span>(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true"; title="class or interface in java.lang">String</a> baseName, - <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true"; title="class or interface in java.lang">String</a> targetName)</code> +<td class="colFirst"><code>java.lang.String</code></td> +<td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#toFullTemplateName-java.lang.String-java.lang.String-">toFullTemplateName</a></span>(java.lang.String baseName, + java.lang.String targetName)</code> <div class="block">Resolves a reference to a template (like the one used in <code>#include</code> or <code>#import</code>), assuming a base name.</div> </td> @@ -660,8 +661,8 @@ extends <a href="../../freemarker/core/Configurable.html" title="class in freema <td class="colFirst"><code>void</code></td> <td class="colLast"><code><span class="memberNameLink"><a href="../../freemarker/core/Environment.html#visit-freemarker.core.TemplateElement-freemarker.template.TemplateDirectiveModel-java.util.Map-java.util.List-">visit</a></span>(freemarker.core.TemplateElement element, <a href="../../freemarker/template/TemplateDirectiveModel.html" title="interface in freemarker.template">TemplateDirectiveModel</a> directiveModel, - <a href="http://docs.oracle.com/javase/8/docs/api/java/util/Map.html?is-external=true"; title="class or interface in java.util">Map</a> args, - <a href="http://docs.oracle.com/javase/8/docs/api/java/util/List.html?is-external=true"; title="class or interface in java.util">List</a> bodyParameterNames)</code> + java.util.Map args, + java.util.List bodyParameterNames)</code> <div class="block"><span class="deprecatedLabel">Deprecated.</span> <div class="block"><span class="deprecationComment">Should be internal API</span></div> </div> @@ -679,8 +680,8 @@ extends <a href="../../freemarker/core/Configurable.html" title="class in freema <li class="blockList"><a name="methods.inherited.from.class.java.lang.Object"> <!-- --> </a> -<h3>Methods inherited from class java.lang.<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true"; title="class or interface in java.lang">Object</a></h3> -<code><a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#equals-java.lang.Object-"; title="class or interface in java.lang">equals</a>, <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#finalize--"; title="class or interface in java.lang">finalize</a>, <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#getClass--"; title="class or interface in java.lang">getClass</a>, <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#hashCode--"; title="class or interface in java.lang">hashCode</a>, <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#notify--"; title="class or interface in java.lang">notify</a>, <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#notifyAll--"; title="class or interface in java.lang">notifyAll</a>, <a href="http://docs.oracle.com/javase/8/docs/api/j ava/lang/Object.html?is-external=true#toString--" title="class or interface in java.lang">toString</a>, <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#wait--"; title="class or interface in java.lang">wait</a>, <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#wait-long-"; title="class or interface in java.lang">wait</a>, <a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Object.html?is-external=true#wait-long-int-"; title="class or interface in java.lang">wait</a></code></li> +<h3>Methods inherited from class java.lang.Object</h3> +<code>equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait</code></li> </ul> </li> </ul> @@ -704,7 +705,7 @@ extends <a href="../../freemarker/core/Configurable.html" title="class in freema <h4>Environment</h4> <pre>public Environment(<a href="../../freemarker/template/Template.html" title="class in freemarker.template">Template</a> template, <a href="../../freemarker/template/TemplateHashModel.html" title="interface in freemarker.template">TemplateHashModel</a> rootDataModel, - <a href="http://docs.oracle.com/javase/8/docs/api/java/io/Writer.html?is-external=true"; title="class or interface in java.io">Writer</a> out)</pre> + java.io.Writer out)</pre> </li> </ul> </li> @@ -734,7 +735,7 @@ extends <a href="../../freemarker/core/Configurable.html" title="class in freema <ul class="blockList"> <li class="blockList"> <h4>getTemplate</h4> -<pre><a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Deprecated.html?is-external=true"; title="class or interface in java.lang">@Deprecated</a> +<pre>@Deprecated public <a href="../../freemarker/template/Template.html" title="class in freemarker.template">Template</a> getTemplate()</pre> <div class="block"><span class="deprecatedLabel">Deprecated.</span> <span class="deprecationComment">Use <a href="../../freemarker/core/Environment.html#getMainTemplate--"><code>getMainTemplate()</code></a> instead (or <a href="../../freemarker/core/Environment.html#getCurrentNamespace--"><code>getCurrentNamespace()</code></a> and then <a href="../../freemarker/core/Environment.Namespace.html#getTemplate--"><code>Environment.Namespace.getTemplate()</code></a>); the value returned by this method is often not what you expect when @@ -806,12 +807,12 @@ public <a href="../../freemarker/template/Template.html" title="class in fr <h4>process</h4> <pre>public void process() throws <a href="../../freemarker/template/TemplateException.html" title="class in freemarker.template">TemplateException</a>, - <a href="http://docs.oracle.com/javase/8/docs/api/java/io/IOException.html?is-external=true"; title="class or interface in java.io">IOException</a></pre> + java.io.IOException</pre> <div class="block">Processes the template to which this environment belongs to.</div> <dl> <dt><span class="throwsLabel">Throws:</span></dt> <dd><code><a href="../../freemarker/template/TemplateException.html" title="class in freemarker.template">TemplateException</a></code></dd> -<dd><code><a href="http://docs.oracle.com/javase/8/docs/api/java/io/IOException.html?is-external=true"; title="class or interface in java.io">IOException</a></code></dd> +<dd><code>java.io.IOException</code></dd> </dl> </li> </ul> @@ -821,18 +822,18 @@ public <a href="../../freemarker/template/Template.html" title="class in fr <ul class="blockList"> <li class="blockList"> <h4>visit</h4> -<pre><a href="http://docs.oracle.com/javase/8/docs/api/java/lang/Deprecated.html?is-external=true"; title="class or interface in java.lang">@Deprecated</a> +<pre>@Deprecated public void visit(freemarker.core.TemplateElement element, - <a href="../../freemarker/template/TemplateDirectiveModel.html" title="interface in freemarker.template">TemplateDirectiveModel</a> directiveModel, - <a href="http://docs.oracle.com/javase/8/docs/api/java/util/Map.html?is-external=true"; title="class or interface in java.util">Map</a> args, - <a href="http://docs.oracle.com/javase/8/docs/api/java/util/List.html?is-external=true"; title="class or interface in java.util">List</a> bodyParameterNames) - throws <a href="../../freemarker/template/TemplateException.html" title="class in freemarker.template">TemplateException</a>, - <a href="http://docs.oracle.com/javase/8/docs/api/java/io/IOException.html?is-external=true"; title="class or interface in java.io">IOException</a></pre> + <a href="../../freemarker/template/TemplateDirectiveModel.html" title="interface in freemarker.template">TemplateDirectiveModel</a> directiveModel, + java.util.Map args, + java.util.List bodyParameterNames) + throws <a href="../../freemarker/template/TemplateException.html" title="class in freemarker.template">TemplateException</a>, + java.io.IOException</pre> <div class="block"><span class="deprecatedLabel">Deprecated.</span> <span class="deprecationComment">Should be internal API</span></div> <dl> <dt><span class="throwsLabel">Throws:</span></dt> <dd><code><a href="../../freemarker/template/TemplateException.html" title="class in freemarker.template">TemplateException</a></code></dd> -<dd><code><a href="http://docs.oracle.com/javase/8/docs/api/java/io/IOException.html?is-external=true"; title="class or interface in java.io">IOException</a></code></dd> +<dd><code>java.io.IOException</code></dd> </dl> </li> </ul> @@ -895,7 +896,7 @@ public void visit(freemarker.core.TemplateElement element, <ul class="blockList"> <li class="blockList"> <h4>setLocale</h4> -<pre>public void setLocale(<a href="http://docs.oracle.com/javase/8/docs/api/java/util/Locale.html?is-external=true"; title="class or interface in java.util">Locale</a> locale)</pre> +<pre>public void setLocale(java.util.Locale locale)</pre> <div class="block"><span class="descfrmTypeLabel">Description copied from class: <code><a href="../../freemarker/core/Configurable.html#setLocale-java.util.Locale-">Configurable</a></code></span></div> <div class="block">Sets the locale used for number and date formatting (among others), also the locale used for searching localized template variations when no locale was explicitly requested. On the <a href="../../freemarker/template/Configuration.html" title="class in freemarker.template"><code>Configuration</code></a> level it @@ -915,10 +916,10 @@ public void visit(freemarker.core.TemplateElement element, <ul class="blockList"> <li class="blockList"> <h4>setTimeZone</h4> -<pre>public void setTimeZone(<a href="http://docs.oracle.com/javase/8/docs/api/java/util/TimeZone.html?is-external=true"; title="class or interface in java.util">TimeZone</a> timeZone)</pre> +<pre>public void setTimeZone(java.util.TimeZone timeZone)</pre> <div class="block"><span class="descfrmTypeLabel">Description copied from class: <code><a href="../../freemarker/core/Configurable.html#setTimeZone-java.util.TimeZone-">Configurable</a></code></span></div> <div class="block">Sets the time zone to use when formatting date/time values. - Defaults to the system time zone (<a href="http://docs.oracle.com/javase/8/docs/api/java/util/TimeZone.html?is-external=true#getDefault--"; title="class or interface in java.util"><code>TimeZone.getDefault()</code></a>), regardless of the "locale" FreeMarker setting, + Defaults to the system time zone (<code>TimeZone.getDefault()</code>), regardless of the "locale" FreeMarker setting, so in a server application you probably want to set it explicitly in the <a href="../../freemarker/core/Environment.html" title="class in freemarker.core"><code>Environment</code></a> to match the preferred time zone of target audience (like the Web page visitor). @@ -938,18 +939,18 @@ public void visit(freemarker.core.TemplateElement element, <ul class="blockList"> <li class="blockList"> <h4>setSQLDateAndTimeTimeZone</h4> -<pre>public void setSQLDateAndTimeTimeZone(<a href="http://docs.oracle.com/javase/8/docs/api/java/util/TimeZone.html?is-external=true"; title="class or interface in java.util">TimeZone</a> timeZone)</pre> +<pre>public void setSQLDateAndTimeTimeZone(java.util.TimeZone timeZone)</pre> <div class="block"><span class="descfrmTypeLabel">Description copied from class: <code><a href="../../freemarker/core/Configurable.html#setSQLDateAndTimeTimeZone-java.util.TimeZone-">Configurable</a></code></span></div> -<div class="block">Sets the time zone used when dealing with <a href="http://docs.oracle.com/javase/8/docs/api/java/sql/Date.html?is-external=true"; title="class or interface in java.sql"><code>java.sql.Date</code></a> and - <a href="http://docs.oracle.com/javase/8/docs/api/java/sql/Time.html?is-external=true"; title="class or interface in java.sql"><code>java.sql.Time</code></a> values. It defaults to <code>null</code> for backward compatibility, but in most +<div class="block">Sets the time zone used when dealing with <code>java.sql.Date</code> and + <code>java.sql.Time</code> values. It defaults to <code>null</code> for backward compatibility, but in most applications this should be set to the JVM default time zone (server default time zone), because that's what - most JDBC drivers will use when constructing the <a href="http://docs.oracle.com/javase/8/docs/api/java/sql/Date.html?is-external=true"; title="class or interface in java.sql"><code>java.sql.Date</code></a> and - <a href="http://docs.oracle.com/javase/8/docs/api/java/sql/Time.html?is-external=true"; title="class or interface in java.sql"><code>java.sql.Time</code></a> values. If this setting is <code>null</code>, FreeMarker will use the value of - (<a href="../../freemarker/core/Configurable.html#getTimeZone--"><code>Configurable.getTimeZone()</code></a>) for <a href="http://docs.oracle.com/javase/8/docs/api/java/sql/Date.html?is-external=true"; title="class or interface in java.sql"><code>java.sql.Date</code></a> and <a href="http://docs.oracle.com/javase/8/docs/api/java/sql/Time.html?is-external=true"; title="class or interface in java.sql"><code>java.sql.Time</code></a> values, + most JDBC drivers will use when constructing the <code>java.sql.Date</code> and + <code>java.sql.Time</code> values. If this setting is <code>null</code>, FreeMarker will use the value of + (<a href="../../freemarker/core/Configurable.html#getTimeZone--"><code>Configurable.getTimeZone()</code></a>) for <code>java.sql.Date</code> and <code>java.sql.Time</code> values, which often gives bad results. <p>This setting doesn't influence the formatting of other kind of values (like of - <a href="http://docs.oracle.com/javase/8/docs/api/java/sql/Timestamp.html?is-external=true"; title="class or interface in java.sql"><code>java.sql.Timestamp</code></a> or plain <a href="http://docs.oracle.com/javase/8/docs/api/java/util/Date.html?is-external=true"; title="class or interface in java.util"><code>java.util.Date</code></a> values). + <code>java.sql.Timestamp</code> or plain <code>java.util.Date</code> values). <p>To decide what value you need, a few things has to be understood: <ul> @@ -959,7 +960,7 @@ public void visit(freemarker.core.TemplateElement element, differently depending on the time zone of the audience. <li>When a JDBC query has to return a date-only or time-only value, it has to convert it to a point on the - physical time line, because that's what <a href="http://docs.oracle.com/javase/8/docs/api/java/util/Date.html?is-external=true"; title="class or interface in java.util"><code>Date</code></a> and its subclasses store (milliseconds since + physical time line, because that's what <code>Date</code> and its subclasses store (milliseconds since the epoch). Obviously, this is impossible to do. So JDBC just chooses a physical time which, when rendered <em>with the JVM default time zone</em>, will give the same field values as those stored in the database. (Actually, you can give JDBC a calendar, and so it can use other time zones too, but most @@ -973,29 +974,29 @@ public void visit(freemarker.core.TemplateElement element, <li>The value of the <code>time_zone</code> FreeMarker configuration setting sets the time zone used for the template output. For example, when a web page visitor has a preferred time zone, the web application framework may calls <a href="../../freemarker/core/Environment.html#setTimeZone-java.util.TimeZone-"><code>setTimeZone(TimeZone)</code></a> with that time zone. Thus, the visitor will - see <a href="http://docs.oracle.com/javase/8/docs/api/java/sql/Timestamp.html?is-external=true"; title="class or interface in java.sql"><code>java.sql.Timestamp</code></a> and plain <a href="http://docs.oracle.com/javase/8/docs/api/java/util/Date.html?is-external=true"; title="class or interface in java.util"><code>java.util.Date</code></a> values as + see <code>java.sql.Timestamp</code> and plain <code>java.util.Date</code> values as they look in his own time zone. While this is desirable for those types, as they meant to represent physical points on the time line, this is not necessarily desirable for date-only and time-only values. When <code>sql_date_and_time_time_zone</code> is <code>null</code>, <code>time_zone</code> is used for rendering all kind of date/time/dateTime values, including - <a href="http://docs.oracle.com/javase/8/docs/api/java/sql/Date.html?is-external=true"; title="class or interface in java.sql"><code>java.sql.Date</code></a> and <a href="http://docs.oracle.com/javase/8/docs/api/java/sql/Time.html?is-external=true"; title="class or interface in java.sql"><code>java.sql.Time</code></a>, and then if, for example, + <code>java.sql.Date</code> and <code>java.sql.Time</code>, and then if, for example, <code>time_zone</code> is GMT+00:00, the values from the earlier examples will be shown as 2014-07-11 (one day off) and 09:57:00 (2 hours off). While those are the time zone correct renderings, those values are probably meant to be shown "as is". <li>You may wonder why this setting isn't simply "SQL time zone", that is, why's this time zone not applied to - <a href="http://docs.oracle.com/javase/8/docs/api/java/sql/Timestamp.html?is-external=true"; title="class or interface in java.sql"><code>java.sql.Timestamp</code></a> values as well. Timestamps in databases refer to a point on + <code>java.sql.Timestamp</code> values as well. Timestamps in databases refer to a point on the physical time line, and thus doesn't have the inherent problem of date-only and time-only values. FreeMarker assumes that the JDBC driver converts time stamps coming from the database so that they store - the distance from the epoch (1970-01-01 00:00:00 UTC), as requested by the <a href="http://docs.oracle.com/javase/8/docs/api/java/util/Date.html?is-external=true"; title="class or interface in java.util"><code>Date</code></a> API. + the distance from the epoch (1970-01-01 00:00:00 UTC), as requested by the <code>Date</code> API. Then time stamps can be safely rendered in different time zones, and thus need no special treatment. </ul></div> <dl> <dt><span class="overrideSpecifyLabel">Overrides:</span></dt> <dd><code><a href="../../freemarker/core/Configurable.html#setSQLDateAndTimeTimeZone-java.util.TimeZone-">setSQLDateAndTimeTimeZone</a></code> in class <code><a href="../../freemarker/core/Configurable.html" title="class in freemarker.core">Configurable</a></code></dd> <dt><span class="paramLabel">Parameters:</span></dt> -<dd><code>timeZone</code> - Maybe <code>null</code>, in which case <a href="http://docs.oracle.com/javase/8/docs/api/java/sql/Date.html?is-external=true"; title="class or interface in java.sql"><code>java.sql.Date</code></a> and - <a href="http://docs.oracle.com/javase/8/docs/api/java/sql/Time.html?is-external=true"; title="class or interface in java.sql"><code>java.sql.Time</code></a> values will be formatted in the time zone returned by +<dd><code>timeZone</code> - Maybe <code>null</code>, in which case <code>java.sql.Date</code> and + <code>java.sql.Time</code> values will be formatted in the time zone returned by <a href="../../freemarker/core/Configurable.html#getTimeZone--"><code>Configurable.getTimeZone()</code></a>. (Note that since <code>null</code> is an allowed value for this setting, it will not cause <a href="../../freemarker/core/Configurable.html#getSQLDateAndTimeTimeZone--"><code>Configurable.getSQLDateAndTimeTimeZone()</code></a> to fall back to the parent configuration.)</dd> @@ -1010,7 +1011,7 @@ public void visit(freemarker.core.TemplateElement element, <ul class="blockList"> <li class="blockList"> <h4>setURLEscapingCharset</h4> -<pre>public void setURLEscapingCharset(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true"; title="class or interface in java.lang">String</a> urlEscapingCharset)</pre> +<pre>public void setURLEscapingCharset(java.lang.String urlEscapingCharset)</pre> <div class="block"><span class="descfrmTypeLabel">Description copied from class: <code><a href="../../freemarker/core/Configurable.html#setURLEscapingCharset-java.lang.String-">Configurable</a></code></span></div> <div class="block">Sets the URL escaping (URL encoding, percentage encoding) charset. If <code>null</code>, the output encoding (<a href="../../freemarker/core/Configurable.html#setOutputEncoding-java.lang.String-"><code>Configurable.setOutputEncoding(String)</code></a>) will be used for URL escaping. @@ -1028,7 +1029,7 @@ public void visit(freemarker.core.TemplateElement element, <ul class="blockList"> <li class="blockList"> <h4>setOutputEncoding</h4> -<pre>public void setOutputEncoding(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true"; title="class or interface in java.lang">String</a> outputEncoding)</pre> +<pre>public void setOutputEncoding(java.lang.String outputEncoding)</pre> <div class="block"><span class="descfrmTypeLabel">Description copied from class: <code><a href="../../freemarker/core/Configurable.html#setOutputEncoding-java.lang.String-">Configurable</a></code></span></div> <div class="block">Informs FreeMarker about the charset used for the output. As FreeMarker outputs character stream (not byte stream), it's not aware of the output charset unless the software that encloses it tells it @@ -1158,7 +1159,7 @@ public void visit(freemarker.core.TemplateElement element, <ul class="blockList"> <li class="blockList"> <h4>setOut</h4> -<pre>public void setOut(<a href="http://docs.oracle.com/javase/8/docs/api/java/io/Writer.html?is-external=true"; title="class or interface in java.io">Writer</a> out)</pre> +<pre>public void setOut(java.io.Writer out)</pre> </li> </ul> <a name="getOut--"> @@ -1167,7 +1168,7 @@ public void visit(freemarker.core.TemplateElement element, <ul class="blockList"> <li class="blockList"> <h4>getOut</h4> -<pre>public <a href="http://docs.oracle.com/javase/8/docs/api/java/io/Writer.html?is-external=true"; title="class or interface in java.io">Writer</a> getOut()</pre> +<pre>public java.io.Writer getOut()</pre> </li> </ul> <a name="setNumberFormat-java.lang.String-"> @@ -1176,15 +1177,15 @@ public void visit(freemarker.core.TemplateElement element, <ul class="blockList"> <li class="blockList"> <h4>setNumberFormat</h4> -<pre>public void setNumberFormat(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true"; title="class or interface in java.lang">String</a> formatName)</pre> +<pre>public void setNumberFormat(java.lang.String formatName)</pre> <div class="block"><span class="descfrmTypeLabel">Description copied from class: <code><a href="../../freemarker/core/Configurable.html#setNumberFormat-java.lang.String-">Configurable</a></code></span></div> <div class="block">Sets the default number format used to convert numbers to strings. Currently, this is one of these: <ul> - <li><code>"number"</code>: The number format returned by <a href="http://docs.oracle.com/javase/8/docs/api/java/text/NumberFormat.html?is-external=true#getNumberInstance-java.util.Locale-"; title="class or interface in java.text"><code>NumberFormat.getNumberInstance(Locale)</code></a></li> - <li><code>"currency"</code>: The number format returned by <a href="http://docs.oracle.com/javase/8/docs/api/java/text/NumberFormat.html?is-external=true#getCurrencyInstance-java.util.Locale-"; title="class or interface in java.text"><code>NumberFormat.getCurrencyInstance(Locale)</code></a></li> - <li><code>"percent"</code>: The number format returned by <a href="http://docs.oracle.com/javase/8/docs/api/java/text/NumberFormat.html?is-external=true#getPercentInstance-java.util.Locale-"; title="class or interface in java.text"><code>NumberFormat.getPercentInstance(Locale)</code></a></li> + <li><code>"number"</code>: The number format returned by <code>NumberFormat.getNumberInstance(Locale)</code></li> + <li><code>"currency"</code>: The number format returned by <code>NumberFormat.getCurrencyInstance(Locale)</code></li> + <li><code>"percent"</code>: The number format returned by <code>NumberFormat.getPercentInstance(Locale)</code></li> <li><code>"computer"</code>: The number format used by FTL's <code>c</code> built-in (like in <code>someNumber?c</code>).</li> - <li><a href="http://docs.oracle.com/javase/8/docs/api/java/text/DecimalFormat.html?is-external=true"; title="class or interface in java.text"><code>DecimalFormat</code></a> pattern (like <code>"0.##"</code>). This syntax is extended by FreeMarker + <li><code>DecimalFormat</code> pattern (like <code>"0.##"</code>). This syntax is extended by FreeMarker so that you can specify options like the rounding mode and the symbols used after a 2nd semicolon. For example, <code>",000;; roundingMode=halfUp groupingSeparator=_"</code> will format numbers like <code>",000"</code> would, but with half-up rounding mode, and <code>_</code> as the group separator. See more about "extended Java @@ -1194,7 +1195,7 @@ public void visit(freemarker.core.TemplateElement element, format, but only if either <a href="../../freemarker/template/Configuration.html#getIncompatibleImprovements--"><code>Configuration.getIncompatibleImprovements()</code></a> is at least 2.3.24, or there's any custom formats defined (even if custom date/time/dateTime format). The format of a such string is <code>"@<i>name</i>"</code> or <code>"@<i>name</i> <i>parameters</i>"</code>, where - <code><i>name</i></code> is the key in the <a href="http://docs.oracle.com/javase/8/docs/api/java/util/Map.html?is-external=true"; title="class or interface in java.util"><code>Map</code></a> set by <a href="../../freemarker/core/Configurable.html#setCustomNumberFormats-java.util.Map-"><code>Configurable.setCustomNumberFormats(Map)</code></a>, and + <code><i>name</i></code> is the key in the <code>Map</code> set by <a href="../../freemarker/core/Configurable.html#setCustomNumberFormats-java.util.Map-"><code>Configurable.setCustomNumberFormats(Map)</code></a>, and <code><i>parameters</i></code> is parsed by the custom <a href="../../freemarker/core/TemplateNumberFormat.html" title="class in freemarker.core"><code>TemplateNumberFormat</code></a>. </li> </ul> @@ -1236,7 +1237,7 @@ public void visit(freemarker.core.TemplateElement element, <ul class="blockList"> <li class="blockList"> <h4>getTemplateNumberFormat</h4> -<pre>public <a href="../../freemarker/core/TemplateNumberFormat.html" title="class in freemarker.core">TemplateNumberFormat</a> getTemplateNumberFormat(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true"; title="class or interface in java.lang">String</a> formatString) +<pre>public <a href="../../freemarker/core/TemplateNumberFormat.html" title="class in freemarker.core">TemplateNumberFormat</a> getTemplateNumberFormat(java.lang.String formatString) throws <a href="../../freemarker/core/TemplateValueFormatException.html" title="class in freemarker.core">TemplateValueFormatException</a></pre> <div class="block">Returns the number format as <a href="../../freemarker/core/TemplateNumberFormat.html" title="class in freemarker.core"><code>TemplateNumberFormat</code></a> for the given format string and the current locale. (The current locale is the locale returned by <a href="../../freemarker/core/Configurable.html#getLocale--"><code>Configurable.getLocale()</code></a>.) Note that the result will be cached in the @@ -1259,8 +1260,8 @@ public void visit(freemarker.core.TemplateElement element, <ul class="blockList"> <li class="blockList"> <h4>getTemplateNumberFormat</h4> -<pre>public <a href="../../freemarker/core/TemplateNumberFormat.html" title="class in freemarker.core">TemplateNumberFormat</a> getTemplateNumberFormat(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true"; title="class or interface in java.lang">String</a> formatString, - <a href="http://docs.oracle.com/javase/8/docs/api/java/util/Locale.html?is-external=true"; title="class or interface in java.util">Locale</a> locale) +<pre>public <a href="../../freemarker/core/TemplateNumberFormat.html" title="class in freemarker.core">TemplateNumberFormat</a> getTemplateNumberFormat(java.lang.String formatString, + java.util.Locale locale) throws <a href="../../freemarker/core/TemplateValueFormatException.html" title="class in freemarker.core">TemplateValueFormatException</a></pre> <div class="block">Returns the number format as <a href="../../freemarker/core/TemplateNumberFormat.html" title="class in freemarker.core"><code>TemplateNumberFormat</code></a>, for the given format string and locale. To get a number format for the current locale, use <a href="../../freemarker/core/Environment.html#getTemplateNumberFormat-java.lang.String-"><code>getTemplateNumberFormat(String)</code></a> instead. @@ -1288,8 +1289,8 @@ public void visit(freemarker.core.TemplateElement element, <ul class="blockList"> <li class="blockList"> <h4>getCNumberFormat</h4> -<pre>public <a href="http://docs.oracle.com/javase/8/docs/api/java/text/NumberFormat.html?is-external=true"; title="class or interface in java.text">NumberFormat</a> getCNumberFormat()</pre> -<div class="block">Returns the <a href="http://docs.oracle.com/javase/8/docs/api/java/text/NumberFormat.html?is-external=true"; title="class or interface in java.text"><code>NumberFormat</code></a> used for the <tt>c</tt> built-in. This is always US English +<pre>public java.text.NumberFormat getCNumberFormat()</pre> +<div class="block">Returns the <code>NumberFormat</code> used for the <tt>c</tt> built-in. This is always US English <code>"0.################"</code>, without grouping and without superfluous decimal separator.</div> </li> </ul> @@ -1299,9 +1300,9 @@ public void visit(freemarker.core.TemplateElement element, <ul class="blockList"> <li class="blockList"> <h4>setTimeFormat</h4> -<pre>public void setTimeFormat(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true"; title="class or interface in java.lang">String</a> timeFormat)</pre> +<pre>public void setTimeFormat(java.lang.String timeFormat)</pre> <div class="block"><span class="descfrmTypeLabel">Description copied from class: <code><a href="../../freemarker/core/Configurable.html#setTimeFormat-java.lang.String-">Configurable</a></code></span></div> -<div class="block">Sets the format used to convert <a href="http://docs.oracle.com/javase/8/docs/api/java/util/Date.html?is-external=true"; title="class or interface in java.util"><code>Date</code></a>-s that are time (no date part) values to string-s, also +<div class="block">Sets the format used to convert <code>Date</code>-s that are time (no date part) values to string-s, also the format that <code>someString?time</code> will use to parse strings. <p>For the possible values see <a href="../../freemarker/core/Configurable.html#setDateTimeFormat-java.lang.String-"><code>Configurable.setDateTimeFormat(String)</code></a>. @@ -1319,9 +1320,9 @@ public void visit(freemarker.core.TemplateElement element, <ul class="blockList"> <li class="blockList"> <h4>setDateFormat</h4> -<pre>public void setDateFormat(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true"; title="class or interface in java.lang">String</a> dateFormat)</pre> +<pre>public void setDateFormat(java.lang.String dateFormat)</pre> <div class="block"><span class="descfrmTypeLabel">Description copied from class: <code><a href="../../freemarker/core/Configurable.html#setDateFormat-java.lang.String-">Configurable</a></code></span></div> -<div class="block">Sets the format used to convert <a href="http://docs.oracle.com/javase/8/docs/api/java/util/Date.html?is-external=true"; title="class or interface in java.util"><code>Date</code></a>-s that are date-only (no time part) values to string-s, +<div class="block">Sets the format used to convert <code>Date</code>-s that are date-only (no time part) values to string-s, also the format that <code>someString?date</code> will use to parse strings. <p>For the possible values see <a href="../../freemarker/core/Configurable.html#setDateTimeFormat-java.lang.String-"><code>Configurable.setDateTimeFormat(String)</code></a>. @@ -1339,15 +1340,15 @@ public void visit(freemarker.core.TemplateElement element, <ul class="blockList"> <li class="blockList"> <h4>setDateTimeFormat</h4> -<pre>public void setDateTimeFormat(<a href="http://docs.oracle.com/javase/8/docs/api/java/lang/String.html?is-external=true"; title="class or interface in java.lang">String</a> dateTimeFormat)</pre> +<pre>public void setDateTimeFormat(java.lang.String dateTimeFormat)</pre> <div class="block"><span class="descfrmTypeLabel">Description copied from class: <code><a href="../../freemarker/core/Configurable.html#setDateTimeFormat-java.lang.String-">Configurable</a></code></span></div> -<div class="block">Sets the format used to convert <a href="http://docs.oracle.com/javase/8/docs/api/java/util/Date.html?is-external=true"; title="class or interface in java.util"><code>Date</code></a>-s that are date-time (timestamp) values to string-s, +<div class="block">Sets the format used to convert <code>Date</code>-s that are date-time (timestamp) values to string-s, also the format that <code>someString?datetime</code> will use to parse strings. <p>The possible setting values are (the quotation marks aren't part of the value itself): <ul> - <li><p>Patterns accepted by Java's <a href="http://docs.oracle.com/javase/8/docs/api/java/text/SimpleDateFormat.html?is-external=true"; title="class or interface in java.text"><code>SimpleDateFormat</code></a>, for example <code>"dd.MM.yyyy HH:mm:ss"</code> (where + <li><p>Patterns accepted by Java's <code>SimpleDateFormat</code>, for example <code>"dd.MM.yyyy HH:mm:ss"</code> (where <code>HH</code> means 24 hours format) or <code>"MM/dd/yyyy hh:mm:ss a"</code> (where <code>a</code> prints AM or PM, if the current language is English). @@ -1368,21 +1369,21 @@ public void visit(freemarker.core.TemplateElement element, <li><p>Time zone offset visibility options:<br> <code>fz</code> = "Force Zone", always show time zone offset (even for for - <a href="http://docs.oracle.com/javase/8/docs/api/java/sql/Date.html?is-external=true"; title="class or interface in java.sql"><code>java.sql.Date</code></a> and <a href="http://docs.oracle.com/javase/8/docs/api/java/sql/Time.html?is-external=true"; title="class or interface in java.sql"><code>java.sql.Time</code></a> values). + <code>java.sql.Date</code> and <code>java.sql.Time</code> values). But, because ISO 8601 doesn't allow for dates (means date without time of the day) to show the zone offset, this option will have no effect in the case of <code>"iso"</code> with dates.<br> <code>nz</code> = "No Zone", never show time zone offset<br> - Neither = always show time zone offset, except for <a href="http://docs.oracle.com/javase/8/docs/api/java/sql/Date.html?is-external=true"; title="class or interface in java.sql"><code>java.sql.Date</code></a> - and <a href="http://docs.oracle.com/javase/8/docs/api/java/sql/Time.html?is-external=true"; title="class or interface in java.sql"><code>java.sql.Time</code></a>, and for <code>"iso"</code> date values. + Neither = always show time zone offset, except for <code>java.sql.Date</code> + and <code>java.sql.Time</code>, and for <code>"iso"</code> date values. <li><p>Time zone options:<br> <code>u</code> = Use UTC instead of what the <code>time_zone</code> setting suggests. However, - <a href="http://docs.oracle.com/javase/8/docs/api/java/sql/Date.html?is-external=true"; title="class or interface in java.sql"><code>java.sql.Date</code></a> and <a href="http://docs.oracle.com/javase/8/docs/api/java/sql/Time.html?is-external=true"; title="class or interface in java.sql"><code>java.sql.Time</code></a> aren't affected + <code>java.sql.Date</code> and <code>java.sql.Time</code> aren't affected by this (see <a href="../../freemarker/core/Configurable.html#setSQLDateAndTimeTimeZone-java.util.TimeZone-"><code>Configurable.setSQLDateAndTimeTimeZone(TimeZone)</code></a> to understand why)<br> <code>fu</code> = "Force UTC", that is, use UTC instead of what the <code>time_zone</code> or the <code>sql_date_and_time_time_zone</code> setting suggests. This also effects - <a href="http://docs.oracle.com/javase/8/docs/api/java/sql/Date.html?is-external=true"; title="class or interface in java.sql"><code>java.sql.Date</code></a> and <a href="http://docs.oracle.com/javase/8/docs/api/java/sql/Time.html?is-external=true"; title="class or interface in java.sql"><code>java.sql.Time</code></a> values<br> + <code>java.sql.Date</code> and <code>java.sql.Time</code> values<br> Neither = Use the time zone suggested by the <code>time_zone</code> or the <code>sql_date_and_time_time_zone</code> configuration setting (<a href="../../freemarker/core/Configurable.html#setTimeZone-java.util.TimeZone-"><code>Configurable.setTimeZone(TimeZone)</code></a> and <a href="../../freemarker/core/Configurable.html#setSQLDateAndTimeTimeZone-java.util.TimeZone-"><code>Configurable.setSQLDateAndTimeTimeZone(TimeZone)</code></a>). @@ -1410,7 +1411,7 @@ public void visit(freemarker.core.TemplateElement element, format. <li><p><code>"short"</code>, <code>"medium"</code>, <code>"long"</code>, or <code>"full"</code>, which that has locale-dependent - meaning defined by the Java platform (see in the documentation of <a href="http://docs.oracle.com/javase/8/docs/api/java/text/DateFormat.html?is-external=true"; title="class or interface in java.text"><code>DateFormat</code></a>). + meaning defined by the Java platform (see in the documentation of <code>DateFormat</code>). For date-time values, you can specify the length of the date and time part independently, be separating them with <code>_</code>, like <code>"short_medium"</code>. (<code>"medium"</code> means <code>"medium_medium"</code> for date-time values.) @@ -1419,7 +1420,7 @@ public void visit(freemarker.core.TemplateElement element, date/time/dateTime format, but only if either <a href="../../freemarker/template/Configuration.html#getIncompatibleImprovements--"><code>Configuration.getIncompatibleImprovements()</code></a> is at least 2.3.24, or there's any custom formats defined (even if custom number format). The format of such string is <code>"@<i>name</i>"</code> or <code>"@<i>name</i> <i>parameters</i>"</code>, where - <code><i>name</i></code> is the key in the <a href="http://docs.oracle.com/javase/8/docs/api/java/util/Map.html?is-external=true"; title="class or interface in java.util"><code>Map</code></a> set by <a href="../../freemarker/core/Configurable.html#setCustomDateFormats-java.util.Map-"><code>Configurable.setCustomDateFormats(Map)</code></a>, and + <code><i>name</i></code> is the key in the <code>Map</code> set by <a href="../../freemarker/core/Configurable.html#setCustomDateFormats-java.util.Map-"><code>Configurable.setCustomDateFormats(Map)</code></a>, and <code><i>parameters</i></code> is parsed by the custom number format. </ul> @@ -1447,7 +1448,7 @@ public void visit(freemarker.core.TemplateElement element, <li class="blockList"> <h4>getTemplateDateFormat</h4> <pre>public <a href="../../freemarker/core/TemplateDateFormat.html" title="class in freemarker.core">TemplateDateFormat</a> getTemplateDateFormat(int dateType, -
<TRUNCATED>
