This is an automated email from the ASF dual-hosted git repository.
asf-gitbox-commits pushed a commit to branch asf-site
in repository https://gitbox.apache.org/repos/asf/hop-website.git
The following commit(s) were added to refs/heads/asf-site by this push:
new 0e939bab0f Website updated to 2ff35d7
0e939bab0f is described below
commit 0e939bab0fafbb26b0273fc9cb745938d9556ae7
Author: jenkins <[email protected]>
AuthorDate: Thu Oct 29 08:10:47 2026 +0000
Website updated to 2ff35d7
---
.../environment-dialog-regional-tab.png | Bin 0 -> 138431 bytes
manual/next/hop-gui/perspective-configuration.html | 13 ++++-
manual/next/projects/projects-environments.html | 60 +++++++++++++++++++--
manual/next/variables.html | 10 ++++
4 files changed, 78 insertions(+), 5 deletions(-)
diff --git
a/manual/next/_images/hop-gui/environment/environment-dialog-regional-tab.png
b/manual/next/_images/hop-gui/environment/environment-dialog-regional-tab.png
new file mode 100644
index 0000000000..ff55cd70c3
Binary files /dev/null and
b/manual/next/_images/hop-gui/environment/environment-dialog-regional-tab.png
differ
diff --git a/manual/next/hop-gui/perspective-configuration.html
b/manual/next/hop-gui/perspective-configuration.html
index c91fb5d47b..2327204371 100644
--- a/manual/next/hop-gui/perspective-configuration.html
+++ b/manual/next/hop-gui/perspective-configuration.html
@@ -3747,6 +3747,9 @@ Because this setting applies to the whole running
process, in Hop Web it belongs
<p>Field-level decimal, grouping, currency, date locale and date timezone on a
transform field. These always win.</p>
</li>
<li>
+<p>The active <a href="../projects/projects-environments.html" class="xref
page">lifecycle environment</a> format locale and timezone, when set.</p>
+</li>
+<li>
<p>This installation tab (operating system, an explicit override, or the
preferred language).</p>
</li>
<li>
@@ -3755,10 +3758,16 @@ Because this setting applies to the whole running
process, in Hop Web it belongs
</ol>
</div>
<div class="paragraph">
-<p>The default source is the operating system. Hop GUI, <code>hop-run</code>
and <code>hop-server</code> then agree <strong>on the same machine</strong>,
but a laptop on <code>nl_BE</code> and a hop-server on <code>en_US</code> still
format blank fields differently. <strong>Override regional settings</strong>
(and copying that <code>hop-config.json</code>) is the way to pin a locale for
an installation. Transform field symbols remain the way to handle a file that
does not match that locale.</p>
+<p>The default source on this tab is the operating system. Hop GUI,
<code>hop-run</code> and <code>hop-server</code> then agree <strong>on the same
machine</strong>, but a laptop on <code>nl_BE</code> and a hop-server on
<code>en_US</code> still format blank fields differently unless the lifecycle
environment pins a locale (or you use <strong>Override regional
settings</strong> and copy that <code>hop-config.json</code>). Transform field
symbols remain the way to handle a file that does [...]
+</div>
+<div class="paragraph">
+<p>When an environment is enabled, Hop publishes the effective values as
<code>${HOP_FORMAT_LOCALE}</code> and <code>${HOP_TIMEZONE}</code> and the
start log line’s <code>source=</code> shows <code>environment:name</code>
instead of <code>installation:…</code>.</p>
+</div>
+<div class="paragraph">
+<p>Distributed Beam and Spark workers never load <code>hop-config.json</code>
or the lifecycle environment. They format with their own JVM locale and
timezone unless the pipeline sets field-level symbols.</p>
</div>
<div class="paragraph">
-<p>Distributed Beam and Spark workers never load <code>hop-config.json</code>.
They format with their own JVM locale and timezone unless the pipeline sets
field-level symbols.</p>
+<p>A hop-server JVM is expected to run one default environment for these
conversion defaults. Mixing environments with different FORMAT locales in one
process is not supported: <code>Locale.setDefault</code> and
<code>TimeZone.setDefault</code> are process-wide. Field-level overrides still
work per pipeline.</p>
</div>
</div>
</div>
diff --git a/manual/next/projects/projects-environments.html
b/manual/next/projects/projects-environments.html
index 5e5a752b80..92a2967755 100644
--- a/manual/next/projects/projects-environments.html
+++ b/manual/next/projects/projects-environments.html
@@ -3261,7 +3261,7 @@ Click it to open the environment menu, then choose
<strong>Add environment…
</div>
<div class="paragraph">
<p>This opens the environment properties dialog.
-The fields are grouped on tabs: <strong>General</strong>,
<strong>Configuration files</strong>, and when the matching plugins are
installed <strong>Marketplace plugins</strong> and <strong>System
resources</strong>.</p>
+The fields are grouped on tabs: <strong>General</strong>,
<strong>Regional</strong>, <strong>Configuration files</strong>, and when the
matching plugins are installed <strong>Marketplace plugins</strong> and
<strong>System resources</strong>.</p>
</div>
<div class="paragraph">
<p><span class="image"><img
src="../_images/hop-gui/environment/environment-dialog-general-tab.png"
alt="Environment Properties General tab" width="90%"></span></p>
@@ -3343,10 +3343,64 @@ The fields are grouped on tabs:
<strong>General</strong>, <strong>Configuration
</tbody>
</table>
<div class="paragraph">
+<p><span class="image"><img
src="../_images/hop-gui/environment/environment-dialog-regional-tab.png"
alt="Environment Properties Regional tab" width="90%"></span></p>
+</div>
+<table id="tab-env-props-regional" class="tableblock frame-all grid-all
stretch">
+<caption class="title">Table 7. Environment
Properties — Regional</caption>
+<colgroup>
+<col style="width: 20%;">
+<col style="width: 45%;">
+<col style="width: 5%;">
+<col style="width: 5%;">
+<col style="width: 25%;">
+</colgroup>
+<thead>
+<tr>
+<th class="tableblock halign-left valign-top">Property</th>
+<th class="tableblock halign-left valign-top">Description</th>
+<th class="tableblock halign-left valign-top">Variables Supported</th>
+<th class="tableblock halign-left valign-top">Mandatory</th>
+<th class="tableblock halign-left valign-top">Default</th>
+</tr>
+</thead>
+<tbody>
+<tr>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Format
locale</p></td>
+<td class="tableblock halign-left valign-top"><div class="content"><div
class="paragraph">
+<p>Locale used for decimal separator, grouping separator, currency and date
formats when this environment is enabled in Hop GUI, <code>hop-run</code> and
<code>hop-server</code>. Independent of the Hop GUI language.</p>
+</div>
+<div class="paragraph">
+<p>Leave <strong>Inherit installation / OS</strong> to use the <a
href="../hop-gui/perspective-configuration.html#_regional_settings" class="xref
page">Configuration perspective Regional settings</a>. Field-level decimal,
grouping and date locale options still override this default. The effective
value is published as <code>'{openvar}HOP_FORMAT_LOCALE{closevar}'</code>.</p>
+</div></div></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">No</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">No</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Inherit
installation / OS</p></td>
+</tr>
+<tr>
+<td class="tableblock halign-left valign-top"><p
class="tableblock">Timezone</p></td>
+<td class="tableblock halign-left valign-top"><div class="content"><div
class="paragraph">
+<p>IANA timezone used as the default for date and timestamp conversion (for
example <code>Europe/Brussels</code>).</p>
+</div>
+<div class="paragraph">
+<p>Leave <strong>Inherit installation / OS</strong> to keep the JVM default.
Field-level date timezones still override this default. The effective value is
published as <code>'{openvar}HOP_TIMEZONE{closevar}'</code>.</p>
+</div></div></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">No</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">No</p></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">Inherit
installation / OS</p></td>
+</tr>
+</tbody>
+</table>
+<div class="paragraph">
+<p>A preview under the two combos shows a sample number, a long date and the
selected timezone, updated as you change the values.</p>
+</div>
+<div class="paragraph">
+<p>Pinning locale and timezone on the environment is how a pipeline that omits
field-level decimal and grouping symbols produces the same result on a laptop
and on a hop-server. Without it, those defaults follow the machine, which is
the classic "it works on my machine" failure.</p>
+</div>
+<div class="paragraph">
<p><span class="image"><img
src="../_images/hop-gui/environment/environment-dialog-configuration-files-tab.png"
alt="Environment Properties Configuration files tab" width="90%"></span></p>
</div>
<table id="tab-env-props-files" class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 7. Environment
Properties — Configuration files</caption>
+<caption class="title">Table 8. Environment
Properties — Configuration files</caption>
<colgroup>
<col style="width: 20%;">
<col style="width: 45%;">
@@ -3564,7 +3618,7 @@ Open the environment properties dialog and select the
<strong>System resources</
<p>Leave a field empty to skip that check.</p>
</div>
<table class="tableblock frame-all grid-all stretch">
-<caption class="title">Table 8. On enable policy</caption>
+<caption class="title">Table 9. On enable policy</caption>
<colgroup>
<col style="width: 20%;">
<col style="width: 80%;">
diff --git a/manual/next/variables.html b/manual/next/variables.html
index 6767e1f4cd..ebcd88749f 100644
--- a/manual/next/variables.html
+++ b/manual/next/variables.html
@@ -3501,6 +3501,11 @@ Set a positive number of milliseconds to change the
interval.
A negative value, for example -1, disables the interval flush.</p></td>
</tr>
<tr>
+<td class="tableblock halign-left valign-top"><p
class="tableblock">HOP_FORMAT_LOCALE</p></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The FORMAT
locale in effect for number, currency and date conversion (for example
<code>en_US</code>). Set automatically when a lifecycle environment with a
format locale is enabled. See <a href="projects/projects-environments.html"
class="xref page">Projects and Environments</a>.</p></td>
+</tr>
+<tr>
<td class="tableblock halign-left valign-top"><p
class="tableblock">HOP_GLOBAL_LOG_VARIABLES_CLEAR_ON_EXPORT</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">N</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">Set this
variable to N to preserve global log variables defined in pipeline / workflow
Properties → Log panel.
@@ -3683,6 +3688,11 @@ Hostname lookup is performed by Hop so that it is
capable of logging the server
<td class="tableblock halign-left valign-top"><p class="tableblock">Number of
spaces Tab inserts and Shift+Tab removes on the selected lines of a multi-line
text field. A line that already starts with a tab gains another tab. Set the
value to 0 to insert a tab on every selected line. Useful when writing
JavaScript, JSON, XML, and similar files that benefit from proper indentation
to recognize file or code structures. Resolved from the Hop configuration, then
the environment variable, the [...]
</tr>
<tr>
+<td class="tableblock halign-left valign-top"><p
class="tableblock">HOP_TIMEZONE</p></td>
+<td class="tableblock halign-left valign-top"></td>
+<td class="tableblock halign-left valign-top"><p class="tableblock">The
default timezone in effect for date and timestamp conversion (IANA id, for
example <code>Europe/Brussels</code>). Set automatically when a lifecycle
environment with a timezone is enabled. See <a
href="projects/projects-environments.html" class="xref page">Projects and
Environments</a>.</p></td>
+</tr>
+<tr>
<td class="tableblock halign-left valign-top"><p
class="tableblock">HOP_TRANSFORM_PERFORMANCE_SNAPSHOT_LIMIT</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">0</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock">The
maximum number of transform performance snapshots to keep in memory.
