From 1eb9e7ad65a9262e80c3329f8c366e95b786eefd Mon Sep 17 00:00:00 2001
From: lacatoire <la.catoire@gmail.com>
Date: Fri, 27 Mar 2026 13:25:57 +0100
Subject: [PATCH] [Sync EN] Add example demonstrating ROUNDING_MODE with
 ROUND_DOWN

---
 .../intl/numberformatter/set-attribute.xml    | 41 ++++++++++++++++++-
 1 file changed, 40 insertions(+), 1 deletion(-)

diff --git a/reference/intl/numberformatter/set-attribute.xml b/reference/intl/numberformatter/set-attribute.xml
index 5feedf50c..965a93135 100644
--- a/reference/intl/numberformatter/set-attribute.xml
+++ b/reference/intl/numberformatter/set-attribute.xml
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 1976eae0d815797af97a1e16c5cd90ffc2868395 Maintainer: PhilDaiguille Status: ready -->
+<!-- EN-Revision: 89b92b42cc3fcbd4481f454139beb20ba3328be2 Maintainer: PhilDaiguille Status: ready -->
 <!-- Reviewed: no -->
 <refentry xml:id="numberformatter.setattribute" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -114,6 +114,45 @@ Digits: 2
 1.234.567,89
 ]]>
   </screen>
+  <example>
+   <title>Uso de <constant>NumberFormatter::ROUNDING_MODE</constant> para truncar valores</title>
+   <simpara>
+    Por defecto, <classname>NumberFormatter</classname> redondea los valores. Usar
+    <constant>NumberFormatter::ROUND_DOWN</constant> como
+    <constant>NumberFormatter::ROUNDING_MODE</constant> trunca
+    el valor al número especificado de dígitos fraccionarios sin redondear.
+   </simpara>
+   <programlisting role="php">
+<![CDATA[
+<?php
+$fmt = new NumberFormatter('en_US', NumberFormatter::DECIMAL);
+$fmt->setAttribute(NumberFormatter::FRACTION_DIGITS, 2);
+
+echo "Default rounding mode:\n";
+echo $fmt->format(3.789), "\n"; // 3.79 (rounded up)
+echo $fmt->format(3.781), "\n"; // 3.78 (rounded down)
+
+$fmt->setAttribute(NumberFormatter::ROUNDING_MODE, NumberFormatter::ROUND_DOWN);
+
+echo "\nWith ROUND_DOWN (truncate):\n";
+echo $fmt->format(3.789), "\n"; // 3.78 (truncated)
+echo $fmt->format(3.781), "\n"; // 3.78 (truncated)
+?>
+]]>
+   </programlisting>
+   &example.outputs;
+   <screen>
+<![CDATA[
+Default rounding mode:
+3.79
+3.78
+
+With ROUND_DOWN (truncate):
+3.78
+3.78
+]]>
+   </screen>
+  </example>
  </refsect1>
 
  <refsect1 role="seealso">