Skip to content

Commit 242a8d5

Browse files
Copilotbrunoborges
andauthored
Add Russian translations for datetime patterns
Translate 6 YAML content files from German to Russian under translations/content/ru/datetime/: - date-formatting.yaml - duration-and-period.yaml - hex-format.yaml - instant-precision.yaml - java-time-basics.yaml - math-clamp.yaml Translated fields: title, oldApproach, modernApproach, summary, explanation, whyModernWins[].title, whyModernWins[].desc, support.description. YAML keys, icons and Java identifiers preserved. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> Co-authored-by: brunoborges <129743+brunoborges@users.noreply.github.com>
1 parent 554d0bd commit 242a8d5

File tree

6 files changed

+102
-0
lines changed

6 files changed

+102
-0
lines changed
Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
title: Форматирование дат
2+
oldApproach: SimpleDateFormat
3+
modernApproach: DateTimeFormatter
4+
summary: Форматируйте значения дат с помощью потокобезопасного неизменяемого DateTimeFormatter.
5+
explanation: DateTimeFormatter неизменяем и потокобезопасен, в отличие от SimpleDateFormat. Его можно сохранять как константу и использовать совместно. Для стандартных форматов доступны предопределённые форматтеры, такие как ISO_LOCAL_DATE.
6+
whyModernWins:
7+
- icon: 🛡️
8+
title: Потокобезопасность
9+
desc: Форматтеры можно использовать между потоками без синхронизации.
10+
- icon: 📋
11+
title: Встроенные форматы
12+
desc: "ISO_LOCAL_DATE, ISO_INSTANT и другие для стандартных форматов."
13+
- icon: 🔒
14+
title: Неизменяемость
15+
desc: Можно безопасно хранить как static final константу.
16+
support:
17+
description: Широко доступен начиная с JDK 8 (март 2014)
Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
title: Duration и Period
2+
oldApproach: Арифметика в миллисекундах
3+
modernApproach: Duration / Period
4+
summary: Вычисляйте разницу во времени типобезопасно с помощью Duration и Period.
5+
explanation: Duration представляет временны́е величины (часы, минуты, секунды). Period представляет календарные величины (годы, месяцы, дни). ChronoUnit.between() подходит для простых разниц. Все классы корректно обрабатывают граничные случаи.
6+
whyModernWins:
7+
- icon: 🎯
8+
title: Типобезопасность
9+
desc: "Duration для времени, Period для даты — никакой путаницы."
10+
- icon: 🛡️
11+
title: Корректные вычисления
12+
desc: "Обрабатывает переход на летнее время, високосные годы и секунды координации."
13+
- icon: 📖
14+
title: Читаемость
15+
desc: ChronoUnit.DAYS.between() читается как естественный язык.
16+
support:
17+
description: Широко доступен начиная с JDK 8 (март 2014)
Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
title: HexFormat
2+
oldApproach: Ручное шестнадцатеричное преобразование
3+
modernApproach: HexFormat
4+
summary: Преобразуйте шестнадцатеричные строки в байтовые массивы и обратно с помощью HexFormat.
5+
explanation: "HexFormat обеспечивает двунаправленное кодирование и декодирование hex для байтов, целых чисел и массивов. Разделители, префиксы, суффиксы и регистр символов настраиваемы. Ручное форматирование и разбор больше не нужны."
6+
whyModernWins:
7+
- icon: 📐
8+
title: Двунаправленность
9+
desc: "Преобразуйте байты→hex и hex→байты с помощью единого API."
10+
- icon: 🔧
11+
title: Настраиваемость
12+
desc: "Разделители, префикс, суффикс, регистр символов."
13+
- icon: 📦
14+
title: Поддержка массивов
15+
desc: Кодирование и декодирование целых байтовых массивов за один раз.
16+
support:
17+
description: Широко доступен начиная с JDK 17 LTS (сентябрь 2021)
Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
title: Instant с точностью до наносекунд
2+
oldApproach: Миллисекунды
3+
modernApproach: Наносекунды
4+
summary: Получайте временны́е метки с точностью до микросекунд или наносекунд.
5+
explanation: "Java 9 улучшила разрешение часов, и теперь Instant.now() на большинстве платформ обеспечивает точность до микросекунд (на некоторых — до наносекунд). Устаревший currentTimeMillis() предоставляет точность только до миллисекунд."
6+
whyModernWins:
7+
- icon: 🎯
8+
title: Высокая точность
9+
desc: "Временны́е метки с точностью до микросекунд/наносекунд вместо миллисекунд."
10+
- icon: 📐
11+
title: Типобезопасность
12+
desc: "Instant несёт в себе свою точность — никаких неоднозначных значений long."
13+
- icon: 🌐
14+
title: Основан на UTC
15+
desc: "Instant всегда в UTC — никакой путаницы с часовыми поясами."
16+
support:
17+
description: Широко доступен начиная с JDK 9 (сентябрь 2017)
Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
title: Основы API java.time
2+
oldApproach: Date + Calendar
3+
modernApproach: java.time.*
4+
summary: Используйте неизменяемые и понятные типы даты/времени вместо Date и Calendar.
5+
explanation: "java.time предоставляет LocalDate, LocalTime, LocalDateTime, Instant и ZonedDateTime — все неизменяемые и потокобезопасные. Месяцы индексируются с 1. Больше никакой путаницы с Calendar.JANUARY = 0."
6+
whyModernWins:
7+
- icon: 🔒
8+
title: Неизменяемость
9+
desc: Значения даты/времени не могут быть случайно изменены.
10+
- icon: 📖
11+
title: Понятный API
12+
desc: "Month.JANUARY вместо 0. DayOfWeek.MONDAY вместо 2."
13+
- icon: 🛡️
14+
title: Потокобезопасность
15+
desc: "Синхронизация не требуется — можно свободно использовать между потоками."
16+
support:
17+
description: Широко доступен начиная с JDK 8 (март 2014)
Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
title: Math.clamp()
2+
oldApproach: Вложенные min/max
3+
modernApproach: Math.clamp()
4+
summary: Ограничьте значение диапазоном с помощью единственного понятного вызова.
5+
explanation: "Math.clamp(value, min, max) ограничивает значение диапазоном [min, max]. Понятнее, чем вложенные Math.min/Math.max, и доступен для int, long, float и double."
6+
whyModernWins:
7+
- icon: 📖
8+
title: Самодокументируемый
9+
desc: "clamp(value, min, max) однозначен."
10+
- icon: 🛡️
11+
title: Меньше ошибок
12+
desc: Больше никакой случайной перестановки порядка min и max.
13+
- icon: 🎯
14+
title: Все числовые типы
15+
desc: "Работает с int, long, float и double."
16+
support:
17+
description: Широко доступен начиная с JDK 21 LTS (сентябрь 2023)

0 commit comments

Comments
 (0)