mirror of
https://github.com/treffynnon/sqlstyle.guide.git
synced 2025-03-09 12:49:51 -05:00
fix: use ISO date format with added T (fixes #82)
This commit is contained in:
parent
a29514f876
commit
e8a3922bbd
14 changed files with 15 additions and 15 deletions
|
@ -32,7 +32,7 @@ Namensnennung - Weitergabe unter gleichen Bedingungen 4.0 International]
|
|||
* Verwenden Sie den Leerraum und die Einrückung vernünftigerweise, um den Code
|
||||
lesbarer zu machen.
|
||||
* Speichern Sie [ISO‑8601][iso-8601-de] konforme Zeit- und
|
||||
Datumsinformationen: `YYYY‑MM‑DD HH:MM:SS.SSSSS`.
|
||||
Datumsinformationen: `YYYY‑MM‑DDTHH:MM:SS.SSSSS`.
|
||||
* Versuchen Sie, aus Gründen der Portabilität nur Standard‑SQL‑Funktionen
|
||||
anstelle von herstellerspezifischen Funktionen zu verwenden.
|
||||
* Halten Sie den Code prägnant und ohne redundante SQL, wie z.B. unnötige
|
||||
|
|
|
@ -19,7 +19,7 @@ Fondé sur un travail disponible sur [https://www.sqlstyle.guide/][sqlstyleguide
|
|||
|
||||
* Utilisez des identifiants et noms cohérents et descriptifs.
|
||||
* Faites un usage judicieux de l'espace et de l'indentation afin de faciliter la lecture du code.
|
||||
* Utilisez la norme [ISO 8601][iso-8601] pour les informations temporelles (`YYYY-MM-DD HH:MM:SS.SSSSS`).
|
||||
* Utilisez la norme [ISO 8601][iso-8601] pour les informations temporelles (`YYYY-MM-DDTHH:MM:SS.SSSSS`).
|
||||
* Essayez de n'utiliser que des fonctions SQL standard au lieu des fonctions spécifiques à chaque SGBD pour des raisons de portabilité.
|
||||
* Gardez le code court et évitez les redondances comme les parenthèses ou guillemets superflus, ou encore les clauses `WHERE` qui peuvent être dérivées.
|
||||
* Commentez le code SQL lorsque c'est nécessaire. Utilisez le style de commentaires du langage C, en ouvrant avec `/*` et fermant avec `*/` là où c'est possible, autrement débutez les commentaires avec `--` et faites-les suivre par une nouvelle ligne.
|
||||
|
|
|
@ -24,7 +24,7 @@ SQL style guide di [Simon Holywell][simon] è autorizzata sotto la licenza
|
|||
|
||||
- Usare nome e identificativi consistenti e descrittivi.
|
||||
- Fare un uso giudizioso degli spazi e indentazione per facilitare la lettura del codice.
|
||||
- Conservare le informazioni relative a data e ora conformi con [ISO 8601][iso-8601] (`YYYY-MM-DD HH:MM:SS.SSSSS`).
|
||||
- Conservare le informazioni relative a data e ora conformi con [ISO 8601][iso-8601] (`YYYY-MM-DDTHH:MM:SS.SSSSS`).
|
||||
- Cercare di utilizzare funzioni SQL standard in luogo di quelle dello specifico fornitore per ragioni di portabilità.
|
||||
- Mantenere il codice conciso ed evitare ridondanza di SQL—tipo l'utilizzo di parentesi o l'inserimento di elementi tra apici non necessari o clausole `WHERE` che potrebbero essere altrimenti derivate.
|
||||
- Includere commenti nel codice SQL laddove necessario. Usare lo stile di commento C con `/*` in apertura e `*/` in chiusura dove possibile, altrimenti far precedere i commenti da `--` e finirli con un ritorno a capo.
|
||||
|
|
|
@ -27,7 +27,7 @@ SQLスタイルガイド by [Simon Holywell][simon] は、[クリエイティブ
|
|||
|
||||
* 一貫性があり説明的な識別子と名前を使用する。
|
||||
* スペースとインデントを慎重に使用しコードを読みやすくする。
|
||||
* [ISO-8601][iso-8601]に準拠した日付時間フォーマット(`YYYY-MM-DD HH:MM:SS.SSSSS`)で格納する。
|
||||
* [ISO-8601][iso-8601]に準拠した日付時間フォーマット(`YYYY-MM-DDTHH:MM:SS.SSSSS`)で格納する。
|
||||
* 移植性のためベンダー固有の関数の代わりに標準のSQL関数のみを使用する。
|
||||
* コードを簡潔で冗長なSQLのない状態に保つ。例えば、不必要なクォート、括弧、他の条件と重なる `WHERE` 句は避ける。
|
||||
* 必要に応じてSQLコードにコメントを挿入する。可能なら `/*` で始まり `*/` で終わるC言語スタイルのコメントを使用し、その他の場合、`--` で始まり改行で終わる行コメントを使用する。
|
||||
|
|
|
@ -25,7 +25,7 @@
|
|||
* 일관적이고 기술적인(descriptive) 식별자와 이름을 사용하라.
|
||||
* 가독성을 위해 공백과 들여쓰기를 신중하게 사용하라.
|
||||
* [ISO 8601][iso-8601]를 따르는 시간 및 날짜 정보를 저장하라.
|
||||
(`YYYY-MM-DD HH:MM:SS.SSSSS`)
|
||||
(`YYYY-MM-DDTHH:MM:SS.SSSSS`)
|
||||
* 이식성을 위해 벤더-특화된 함수 대신 표준 SQL 함수만을 사용하라.
|
||||
* 불필요한 따옴표나 괄호, 다른 구문을 통해 파생될 수 있는 `WHERE`절과 같은 불필요한 SQL을 피하고
|
||||
간결하게 유지하라.
|
||||
|
|
|
@ -27,7 +27,7 @@ Based on a work at [https://www.sqlstyle.guide/][sqlstyleguide].
|
|||
* Use consistent and descriptive identifiers and names.
|
||||
* Make judicious use of white space and indentation to make code easier to read.
|
||||
* Store [ISO 8601][iso-8601] compliant time and date information
|
||||
(`YYYY-MM-DD HH:MM:SS.SSSSS`).
|
||||
(`YYYY-MM-DDTHH:MM:SS.SSSSS`).
|
||||
* Try to only use standard SQL functions instead of vendor-specific functions for
|
||||
reasons of portability.
|
||||
* Keep code succinct and devoid of redundant SQL—such as unnecessary quoting or
|
||||
|
|
|
@ -31,9 +31,9 @@ Międzynarodowe][licence]. Na podstawie pracy dostępnej pod adresem
|
|||
|
||||
* Używaj spójnych oraz opisowych identyfikatorów i nazw.
|
||||
* Rozsądnie wykorzystuj białe znaki i wcięcia, tak aby ułatwić czytanie kodu.
|
||||
* Przechowuj informacje o czasie i dacie w formacie zgodnym z [ISO 8601][iso-8601]
|
||||
(`YYYY-MM-DD HH:MM:SS.SSSSS`).
|
||||
* Ze względu na przenośność kodu staraj się używać wyłącznie standardowych funkcji SQL
|
||||
* Przechowuj informacje o czasie i dacie w formacie zgodnym z [ISO 8601][iso-8601]
|
||||
(`YYYY-MM-DDTHH:MM:SS.SSSSS`).
|
||||
zamiast funkcji specyficznych dla danego dostawcy silnika bazodanowego.
|
||||
* Kod powinien być zwięzły i pozbawiony zbędnego kodu SQL, np. bez zbędnych cudzysłowów,
|
||||
nawiasów lub klauzul `WHERE`, które mogą być wyprowadzone w inny sposób.
|
||||
|
|
|
@ -30,7 +30,7 @@ Baseado no trabalho em [https://www.sqlstyle.guide][sqlstyleguide].
|
|||
* Tenha critério ao utilizar espaços em branco e indentação para melhorar
|
||||
a legibilidade do código.
|
||||
* Armazene informações de data e hora compatíveis com [ISO-8601][iso-8601]
|
||||
(`YYYY-MM-DD HH:MM:SS.SSSSS`).
|
||||
(`YYYY-MM-DDTHH:MM:SS.SSSSS`).
|
||||
* Por questões de portabilidade, tente utilizar apenas funções SQL padrão no lugar
|
||||
de funções específicas de servidores SQL de fornecedores.
|
||||
* Mantenha o código sucinto e desprovido de SQL redundante—como adição de aspas
|
||||
|
|
|
@ -36,7 +36,7 @@ GitHub'е.
|
|||
* **Идентификаторы и имена**. Осмысленные и в едином стиле.
|
||||
* **Пробелы и отступы**. Логично расставленные для лучшей читаемости кода.
|
||||
* **Дата и время**. Соответствующие стандарту [ISO 8601][iso-8601-ru]:
|
||||
`YYYY-MM-DD HH:MM:SS.SSSSS`.
|
||||
`YYYY-MM-DDTHH:MM:SS.SSSSS`.
|
||||
* **Функции SQL**. Стандартные вместо специфичных (определяемых поставщиком) с
|
||||
целью лучшей переносимости.
|
||||
* **Код**. Лаконичный и без излишеств, как например: ненужные кавычки или
|
||||
|
|
|
@ -29,7 +29,7 @@ Attribution-ShareAlike 4.0 International License][licence] lisansı ile lisansla
|
|||
* Uygun ve açıklayıcı isimler kullanın.
|
||||
* Girintileri ve boşlukları güzelce kullanarak kodu daha okunabilir yapın.
|
||||
* Tarih ve zaman bilgisini [ISO 8601][iso-8601] uygunluğunda depolayın
|
||||
(`YYYY-MM-DD HH:MM:SS.SSSSS`).
|
||||
(`YYYY-MM-DDTHH:MM:SS.SSSSS`).
|
||||
* Taşınabilirlik için dağıtıma/versiyona özel fonksiyonlar yerine sadece
|
||||
standart SQL fonksiyonlarını kullanmaya çalışın.
|
||||
* Gereksiz tırnak işareti veya başka türlü de türetilebilecek `WHERE`
|
||||
|
|
|
@ -24,7 +24,7 @@ Attribution-ShareAlike 4.0 International License][licence].
|
|||
|
||||
* Використовуйте послідовні та описові ідентифікатори та імена;
|
||||
* Розумно використовуйте пробіли і відступи, щоб полегшити читання коду;
|
||||
* Зберігайте інформацію про час і дату відповідно до [ISO 8601][iso-8601] (`YYYY-MM-DD HH:MM:SS.SSSSS`);
|
||||
* Зберігайте інформацію про час і дату відповідно до [ISO 8601][iso-8601] (`YYYY-MM-DDTHH:MM:SS.SSSSS`);
|
||||
* З міркувань портативності намагайтеся використовувати лише стандартні функції SQL замість функцій постачальника;
|
||||
* Зробіть код стислим і позбавленим зайвого SQL, наприклад, непотрібних лапок або дужок або речень `WHERE`,
|
||||
які можна отримати інакше;
|
||||
|
|
|
@ -17,7 +17,7 @@ Có tham khảo [https://www.sqlstyle.guide/][sqlstyleguide].
|
|||
|
||||
* Hãy đặt tên bảng/cột/biến dễ hiểu và có tính thống nhất
|
||||
* Căn lề hoặc thêm khoảng trống phù hợp sẽ giúp code dễ đọc hơn.
|
||||
* Nếu cần lưu trữ thông tin dạng DATETIME thì hãy tuân thủ quy chuẩn [ISO 8601][iso-8601] (`YYYY-MM-DD HH:MM:SS.SSSSS`).
|
||||
* Nếu cần lưu trữ thông tin dạng DATETIME thì hãy tuân thủ quy chuẩn [ISO 8601][iso-8601] (`YYYY-MM-DDTHH:MM:SS.SSSSS`).
|
||||
* Cố gắng chỉ sử dụng các hàm SQL tiêu chuẩn thay vì các hàm đặc thù của vendor, vì làm như vậy sẽ khiến đoạn code dễ dàng mang sang sử dụng ở dự án khác hơn.
|
||||
* Cố viết code thật gọn, đừng viết thừa (tiêu biểu là các dấu ' và " hay các mệnh đề `WHERE` có thể kế thừa)
|
||||
* Sử dụng comment khi cần. Bạn có thể sử dụng comment kiểu ngôn ngữ C (mở bằng `/*` và đóng bằng `*/`), hoặc comment cả dòng bằng `--`
|
||||
|
|
|
@ -18,7 +18,7 @@
|
|||
|
||||
* 使用一致的、敘述性的名稱。
|
||||
* 靈活使用空格和縮排來增強可讀性。
|
||||
* 儲存符合 [ISO-8601][iso-8601] 標準的日期格式(`YYYY-MM-DD HH:MM:SS.SSSSS`)。
|
||||
* 儲存符合 [ISO-8601][iso-8601] 標準的日期格式(`YYYY-MM-DDTHH:MM:SS.SSSSS`)。
|
||||
* 最好使用標準 SQL 函式而不是特定供應商的函式以提高可移植性。
|
||||
* 保證程式簡潔明了並消除多餘的 SQL(比如非必要的引號或括號,或者可以推導出的多餘 `WHERE` 語句)。
|
||||
* 必要時在 SQL 程式碼中加入註解。優先使用 C 語言式的以 `/*` 開始以 `*/` 結束的區塊註解,或使用以 `--` 開始的單行註解。
|
||||
|
|
|
@ -18,7 +18,7 @@
|
|||
|
||||
* 使用一致的、描述性的名称。
|
||||
* 合理地使用空格和缩进来增强可读性。
|
||||
* 存储符合 [ISO-8601][iso-8601] 标准的日期格式(`YYYY-MM-DD HH:MM:SS.SSSSS`)。
|
||||
* 存储符合 [ISO-8601][iso-8601] 标准的日期格式(`YYYY-MM-DDTHH:MM:SS.SSSSS`)。
|
||||
* 为了提高可移植性,最好仅使用标准 SQL 函数而不是特定供应商的函数。
|
||||
* 保证代码简洁明了、没有多余的 SQL —— 比如非必要的引号或括号,或者可以推导出的 `WHERE` 子句。
|
||||
* 必要时在 SQL 代码中加入注释。优先使用 C 语言式的以 `/*` 开始以 `*/` 结束的块注释,或使用以 `--` 开始的行注释,并在末尾换行。
|
||||
|
|
Loading…
Reference in a new issue