From cc7d00af4554e5e59c26a0c425a8a74d961c08aa Mon Sep 17 00:00:00 2001
From: rodriguez <rodriguez@pragmatismo.com.br>
Date: Mon, 29 Sep 2025 13:29:28 +0000
Subject: [PATCH] Add docs/keywords/format.md

---
 docs/keywords/format.md | 55 +++++++++++++++++++++++++++++++++++++++++
 1 file changed, 55 insertions(+)
 create mode 100644 docs/keywords/format.md

diff --git a/docs/keywords/format.md b/docs/keywords/format.md
new file mode 100644
index 0000000..a5c4f15
--- /dev/null
+++ b/docs/keywords/format.md
@@ -0,0 +1,55 @@
+**FORMAT FUNCTION - PATTERN REFERENCE**
+
+**SYNTAX:** `FORMAT(value, pattern)`
+
+**PATTERN TABLE:**
+
+| CATEGORY | PATTERN | OUTPUT EXAMPLE | DESCRIPTION |
+|----------|---------|----------------|-------------|
+| **DATE** | `yyyy` | 2024 | 4-digit year |
+| | `yy` | 24 | 2-digit year |
+| | `MM` | 01 | 2-digit month |
+| | `M` | 1 | 1-2 digit month |
+| | `dd` | 05 | 2-digit day |
+| | `d` | 5 | 1-2 digit day |
+| **TIME** | `HH` | 14 | 24-hour, 2-digit |
+| | `H` | 14 | 24-hour, 1-2 digit |
+| | `hh` | 02 | 12-hour, 2-digit |
+| | `h` | 2 | 12-hour, 1-2 digit |
+| | `mm` | 08 | 2-digit minutes |
+| | `m` | 8 | 1-2 digit minutes |
+| | `ss` | 09 | 2-digit seconds |
+| | `s` | 9 | 1-2 digit seconds |
+| | `tt` | PM | AM/PM designator |
+| | `t` | P | A/P designator |
+| | `fff` | 123 | Milliseconds |
+| **CURRENCY** | `C` | $ | Currency symbol |
+| | `c` | 123.45 | Currency amount |
+| | `N` | 1,234.56 | Number with commas |
+| | `n` | 1234.56 | Number without commas |
+| | `F` | 123.00 | Fixed decimal |
+| | `f` | 123.45 | Float decimal |
+| | `0` | 0.00 | Zero placeholder |
+| | `#` | #.## | Digit placeholder |
+| **NUMERIC** | `0` | 0 | Required digit |
+| | `#` | # | Optional digit |
+| | `.` | . | Decimal point |
+| | `,` | , | Thousands separator |
+| | `%` | % | Percentage |
+| **TEXT** | `@` | TEXT | Character placeholder |
+| | `&` | text | Lowercase text |
+| | `>` | TEXT | Uppercase text |
+| | `<` | text | Force lowercase |
+| | `!` | T | Force uppercase |
+
+**COMMON COMBINATIONS:**
+- `yyyy-MM-dd` → 2024-01-15
+- `MM/dd/yy` → 01/15/24
+- `HH:mm:ss` → 14:30:45
+- `C0.00` → $123.45
+- `N2` → 1,234.56
+
+**USAGE:**
+`FORMAT(123.456, "C2")` → "$123.46"
+`FORMAT(NOW(), "yyyy-MM-dd HH:mm")` → "2024-01-15 14:30"
+`FORMAT(0.15, "0%")` → "15%"
\ No newline at end of file